|
| 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. |
0 commit comments