surface
Installation
SKILL.md
Surface
Make software easier for agents to discover, understand, call, recover from, and be
evaluated against. This skill is product-side and framework-neutral: it improves the
contact points agents use to reach existing software, not the internals of an agent you are
building. For agent-internal architecture (frameworks, orchestration, memory, model routing,
an agent's own retrieval/RAG pipeline), see the agent-building inventory at /docs/agents
and /docs/agent-retrieval - that inventory sits outside this skill.
Surface has three routes:
- Guide: explain agent-surface concepts, standards, and implementation patterns.
- Audit: detect project surfaces, score agent readiness, produce findings, and write transformation plans (plan and transform are Audit modes, not separate routes).
- Scaffold: create or extend agent surfaces (discovery files, API/CLI/MCP surfaces, tool contracts, retrieval endpoints) and the evaluation harnesses that verify them.
Use the existing project shape first. Read files before making claims or generating code.