Agnostic Prompt Standard (APS) v1.0 — Skill Entry

This SKILL.md is the entrypoint for the Agnostic Prompt Standard (APS) v1.0.

• The APS normative spec is in references/ (those documents define the standard).
• Everything else in this repository is supporting material (examples, templates, platform adapters).

Normative spec (APS v1.0)

1. [00 Structure](references/00-structure.md)
2. [01 Vocabulary](references/01-vocabulary.md)
3. [02 Linting and formatting](references/02-linting-and-formatting.md)
4. [03 Agentic control](references/03-agentic-control.md)
5. [04 Schemas and types](references/04-schemas-and-types.md)
6. [05 Grammar](references/05-grammar.md)
7. [06 Logging and privacy](references/06-logging-and-privacy.md)
8. [07 Error taxonomy](references/07-error-taxonomy.md)

Skill layout

• SKILL.md — this file (skill entrypoint).
• references/ — the APS v1.0 normative documents (this is what an LSP/linter should ingest).
• assets/ — reusable examples for <format> and <constants> blocks.

- constants/ — example constants blocks. - constants-json-block-v1.0.0.example.md - constants-text-block-v1.0.0.example.md - constants-csv-block-v1.0.0.example.md - composites/ — combined reference examples. - gui-component-spec-v1.0.0.example.md - mcp-tool-bridge-v1.0.0.example.md - formats/ — example format blocks. - format-code-changes-full-v1.0.0.example.md - format-code-map-v1.0.0.example.md - format-docs-index-v1.0.0.example.md - format-error-v1.0.0.example.md - format-hierarchical-outline-v1.0.0.example.md - format-ideation-list-v1.0.0.example.md - format-link-manifest-v1.0.0.example.md - format-markdown-table-v1.0.0.example.md - format-smeac-plan-v1.0.0.example.md - format-table-api-coverage-v1.0.0.example.md

• _template/ — minimal skill skeleton for scaffolding new skills.

- SKILL.md — stub entrypoint with placeholder frontmatter. - references/, assets/constants/, assets/formats/, processes/, scripts/, guides/ — empty placeholder directories.

• processes/ — executable APS process documents (skill-specific workflows).

- build-skill.md — process for building new APS-compliant skills.

• guides/ — reference documents for humans and agents.

- skill-authoring-v1.0.0.guide.md — skill authoring reference. - mcp-tool-bridge-v1.0.0.guide.md — MCP tool bridge integration guide. - subagent-architecture-v1.0.0.guide.md — cross-platform subagent architecture and interface mapping guide.

• platforms/ — non-normative platform adapters. Each platform has a single adaptor.md file.

- README.md — platforms overview and contract. - _template/ — skeleton for new platform adapters. - adaptor.md - claude-code/ — Claude Code CLI adapter. - adaptor.md — platform constants, tool registry, and format contracts. - generic/ — generic / external tools adapter. - adaptor.md — neutral tool mapping guidance for MCP or other external tool layers. - opencode/ — OpenCode adapter. - adaptor.md — platform constants. - vscode-copilot/ — VS Code + GitHub Copilot adapter. - adaptor.md — platform constants, tool registry, and format contracts.

• scripts/ — optional build / compile / lint scripts (empty by default).

Platform adapters

Platform-specific details (file discovery, frontmatter dialects, tool naming, and coordinator/worker orchestration) are documented in platforms/.

→ See [platforms/README.md](platforms/README.md) for overview and how to add new adapters.

→ See [guides/subagent-architecture-v1.0.0.guide.md](guides/subagent-architecture-v1.0.0.guide.md) for portable coordinator/worker authoring guidance.

VS Code + GitHub Copilot

The initial adapter for VS Code + GitHub Copilot is at platforms/vscode-copilot/.

→ See [platforms/vscode-copilot/adaptor.md](platforms/vscode-copilot/adaptor.md) for platform constants, tool registry, and format contracts.