agnostic-prompt-standard

name: agnostic-prompt-standard description: The reference framework to generate, compile, and lint greenfield prompts that conform to the Agnostic Prompt Standard (APS) v1.0. license: MIT metadata: repository: "https://github.com/chris-buckley/agnostic-prompt-standard" author: "Christopher Buckley" co_authors: "Juan Burckhardt; Anastasiya Smirnova" spec_version: "1.0" framework_revision: "1.1.11" last_updated: "2026-01-15"

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
  • 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
• platforms/ — non-normative platform adapters (file conventions, frontmatter, tool registries, templates).
  • README.md — platforms overview and contract.
  • _schemas/ — JSON Schemas for adapter validation.
    • platform-manifest.schema.json
    • tools-registry.schema.json
  • _template/ — skeleton for new platform adapters.
    • README.md, manifest.json, tools-registry.json
  • vscode-copilot/ — VS Code + GitHub Copilot adapter.
    • README.md — adapter quickstart and nuances.
    • manifest.json — file discovery rules.
    • tools-registry.json — tool names, sets, and renames.
    • frontmatter/ — copy/paste YAML frontmatter templates.
• scripts/ — optional build / compile / lint scripts (empty by default).

Platform adapters

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

→ See platforms/README.md for overview and how to add new adapters.

VS Code + GitHub Copilot

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

→ See platforms/vscode-copilot/README.md for quickstart, file discovery, frontmatter templates, and tool naming.