Agnostic Prompt Standard

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
2. 01 Vocabulary
3. 02 Linting and formatting
4. 03 Agentic control
5. 04 Schemas and types
6. 05 Grammar
7. 06 Logging and privacy
8. 07 Error taxonomy

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 for overview and how to add new adapters.

→ See 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 for platform constants, tool registry, and format contracts.