agnostic-prompt-standard

Category: Development & Coding | Uploader: chris-buckley | Downloads: 0 | Version: v1.0（Latest）

The reference framework to generate, compile, and lint greenfield prompts that conform to the Agnostic Prompt Standard (APS) v1.0.

Changelog: Source: GitHub https://github.com/chris-buckley/agnostic-prompt-standard

Directory Structure

Current level: skill/agnostic-prompt-standard/

📁 _template/
- 📁 assets/
  - 📁 constants/
    
    📄 .gitkeep 0 B
  - 📁 formats/
    
    📄 .gitkeep 0 B
- 📁 guides/
  - 📄 .gitkeep 0 B
- 📁 processes/
  - 📄 .gitkeep 0 B
- 📁 references/
  - 📄 .gitkeep 0 B
- 📁 scripts/
  - 📄 .gitkeep 0 B
- 📄 SKILL.md 795 B
📁 assets/
- 📁 composites/
  - 📄 gui-component-spec-v1.0.0.example.md 11.5 KB
  - 📄 mcp-tool-bridge-v1.0.0.example.md 2.3 KB
- 📁 constants/
  - 📄 constants-csv-block-v1.0.0.example.md 464 B
  - 📄 constants-json-block-v1.0.0.example.md 322 B
  - 📄 constants-text-block-v1.0.0.example.md 462 B
- 📁 formats/
  - 📄 format-code-changes-full-v1.0.0.example.md 754 B
  - 📄 format-code-map-v1.0.0.example.md 646 B
  - 📄 format-docs-index-v1.0.0.example.md 919 B
  - 📄 format-error-v1.0.0.example.md 435 B
  - 📄 format-hierarchical-outline-v1.0.0.example.md 700 B
  - 📄 format-ideation-list-v1.0.0.example.md 766 B
  - 📄 format-link-manifest-v1.0.0.example.md 560 B
  - 📄 format-markdown-table-v1.0.0.example.md 790 B
  - 📄 format-smeac-plan-v1.0.0.example.md 7.1 KB
  - 📄 format-table-api-coverage-v1.0.0.example.md 805 B
📁 guides/
- 📄 skill-authoring-v1.0.0.guide.md 8.8 KB
- 📄 subagent-architecture-v1.0.0.guide.md 6.9 KB
📁 platforms/
- 📁 _template/
  - 📁 templates/
    
    📁 .github/
    
    📁 agents/
    
    📄 .gitkeep 0 B
  - 📄 adaptor.md 1.5 KB
- 📁 claude-code/
  - 📁 templates/
    
    📁 .claude/
    
    📁 agents/
    
    📄 aps-v1.1.17.md 21.1 KB
  - 📄 adaptor.md 12.6 KB
- 📁 generic/
  - 📄 adaptor.md 3.2 KB
- 📁 opencode/
  - 📄 adaptor.md 7.0 KB
- 📁 vscode-copilot/
  - 📁 templates/
    
    📁 .github/
    
    📁 agents/
    
    📄 aps-v1.1.17.agent.md 21.2 KB
  - 📄 adaptor.md 14.0 KB
- 📄 README.md 3.4 KB
📁 processes/
- 📄 build-skill.md 10.0 KB
📁 references/
- 📄 00-structure.md 5.9 KB
- 📄 01-vocabulary.md 2.6 KB
- 📄 02-linting-and-formatting.md 5.4 KB
- 📄 03-agentic-control.md 7.8 KB
- 📄 04-schemas-and-types.md 8.4 KB
- 📄 05-grammar.md 5.0 KB
- 📄 06-logging-and-privacy.md 753 B
- 📄 07-error-taxonomy.md 5.4 KB
📁 scripts/
- 📄 .gitkeep 0 B
📄 SKILL.md 4.4 KB

SKILL.md

---
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.2.0"
  last_updated: "2026-03-12"
---

# 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.

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

agnostic-prompt-standard

Directory Structure

SKILL.md

Report

Notice