Skip to content

Commit 7a04c1b

Browse files
feat: install Agnostic Prompt Standard (APS) v1.1.16 skill (#83)
- Add APS skill at .github/skills/agnostic-prompt-standard/ - Add APS agent at .github/agents/aps-v1.1.16.agent.md - Add APS badge to README.md Co-authored-by: Copilot <[email protected]>
1 parent 9fb5da7 commit 7a04c1b

43 files changed

Lines changed: 4123 additions & 0 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.github/agents/aps-v1.1.16.agent.md

Lines changed: 470 additions & 0 deletions
Large diffs are not rendered by default.
Lines changed: 83 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,83 @@
1+
---
2+
name: agnostic-prompt-standard
3+
description: The reference framework to generate, compile, and lint greenfield prompts that conform to the Agnostic Prompt Standard (APS) v1.0.
4+
license: MIT
5+
metadata:
6+
repository: "https://github.com/chris-buckley/agnostic-prompt-standard"
7+
author: "Christopher Buckley"
8+
co_authors: "Juan Burckhardt; Anastasiya Smirnova"
9+
spec_version: "1.0"
10+
framework_revision: "1.1.16"
11+
last_updated: "2026-02-18"
12+
---
13+
14+
# Agnostic Prompt Standard (APS) v1.0 — Skill Entry
15+
16+
This `SKILL.md` is the **entrypoint** for the Agnostic Prompt Standard (APS) v1.0.
17+
18+
- The APS **normative spec** is in `references/` (those documents define the standard).
19+
- Everything else in this repository is **supporting material** (examples, templates, platform adapters).
20+
21+
## Normative spec (APS v1.0)
22+
23+
1. [00 Structure](references/00-structure.md)
24+
2. [01 Vocabulary](references/01-vocabulary.md)
25+
3. [02 Linting and formatting](references/02-linting-and-formatting.md)
26+
4. [03 Agentic control](references/03-agentic-control.md)
27+
5. [04 Schemas and types](references/04-schemas-and-types.md)
28+
6. [05 Grammar](references/05-grammar.md)
29+
7. [06 Logging and privacy](references/06-logging-and-privacy.md)
30+
8. [07 Error taxonomy](references/07-error-taxonomy.md)
31+
32+
## Skill layout
33+
34+
- `SKILL.md` — this file (skill entrypoint).
35+
- `references/` — the APS v1.0 normative documents (this is what an LSP/linter should ingest).
36+
- `assets/` — reusable examples for `<format>` and `<constants>` blocks.
37+
- `constants/` — example constants blocks.
38+
- `constants-json-block-v1.0.0.example.md`
39+
- `constants-text-block-v1.0.0.example.md`
40+
- `constants-csv-block-v1.0.0.example.md`
41+
- `formats/` — example format blocks.
42+
- `format-code-changes-full-v1.0.0.example.md`
43+
- `format-code-map-v1.0.0.example.md`
44+
- `format-docs-index-v1.0.0.example.md`
45+
- `format-error-v1.0.0.example.md`
46+
- `format-hierarchical-outline-v1.0.0.example.md`
47+
- `format-ideation-list-v1.0.0.example.md`
48+
- `format-link-manifest-v1.0.0.example.md`
49+
- `format-markdown-table-v1.0.0.example.md`
50+
- `format-smeac-plan-v1.0.0.example.md`
51+
- `format-table-api-coverage-v1.0.0.example.md`
52+
- `_template/` — minimal skill skeleton for scaffolding new skills.
53+
- `SKILL.md` — stub entrypoint with placeholder frontmatter.
54+
- `references/`, `assets/constants/`, `assets/formats/`, `processes/`, `scripts/`, `guides/` — empty placeholder directories.
55+
- `processes/` — executable APS process documents (skill-specific workflows).
56+
- `build-skill.md` — process for building new APS-compliant skills.
57+
- `guides/` — reference documents for humans and agents.
58+
- `skill-authoring-v1.0.0.guide.md` — skill authoring reference.
59+
- `platforms/`**non-normative** platform adapters. Each platform has a single `adaptor.md` file.
60+
- `README.md` — platforms overview and contract.
61+
- `_template/` — skeleton for new platform adapters.
62+
- `adaptor.md`
63+
- `claude-code/` — Claude Code CLI adapter.
64+
- `adaptor.md` — platform constants, tool registry, and format contracts.
65+
- `opencode/` — OpenCode adapter.
66+
- `adaptor.md` — platform constants.
67+
- `vscode-copilot/` — VS Code + GitHub Copilot adapter.
68+
- `adaptor.md` — platform constants, tool registry, and format contracts.
69+
- `scripts/` — optional build / compile / lint scripts (empty by default).
70+
71+
---
72+
73+
## Platform adapters
74+
75+
Platform-specific details (file discovery, frontmatter dialects, tool naming) are documented in `platforms/`.
76+
77+
→ See [platforms/README.md](platforms/README.md) for overview and how to add new adapters.
78+
79+
### VS Code + GitHub Copilot
80+
81+
The initial adapter for VS Code + GitHub Copilot is at `platforms/vscode-copilot/`.
82+
83+
→ See [platforms/vscode-copilot/adaptor.md](platforms/vscode-copilot/adaptor.md) for platform constants, tool registry, and format contracts.
Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
---
2+
name: <skill-id>
3+
description: "<One-sentence skill description>"
4+
license: MIT
5+
metadata:
6+
author: "<Your Name>"
7+
spec_version: "1.0"
8+
framework_revision: "1.0.0"
9+
last_updated: "<YYYY-MM-DD>"
10+
---
11+
12+
# <Skill Name>
13+
14+
<One-paragraph skill overview: what it does, who it is for, and why it exists.>
15+
16+
## References
17+
18+
1. [00 <First reference>](references/00-<name>.md)
19+
20+
## Skill layout
21+
22+
- `SKILL.md` — this file (skill entrypoint).
23+
- `references/` — normative specification documents.
24+
- `assets/` — reusable constants and format contracts.
25+
- `constants/` — constant blocks.
26+
- `formats/` — format contracts.
27+
- `processes/` — executable APS process documents.
28+
- `guides/` — prose reference documents for humans and agents.
29+
- `scripts/` — optional build / compile / lint scripts.

.github/skills/agnostic-prompt-standard/_template/assets/constants/.gitkeep

Whitespace-only changes.

.github/skills/agnostic-prompt-standard/_template/assets/formats/.gitkeep

Whitespace-only changes.

.github/skills/agnostic-prompt-standard/_template/guides/.gitkeep

Whitespace-only changes.

.github/skills/agnostic-prompt-standard/_template/processes/.gitkeep

Whitespace-only changes.

.github/skills/agnostic-prompt-standard/_template/references/.gitkeep

Whitespace-only changes.

.github/skills/agnostic-prompt-standard/_template/scripts/.gitkeep

Whitespace-only changes.

0 commit comments

Comments
 (0)