Agent skill
Contract and prompt for coding agents.
Give your coding agent the Agenko contract before it instruments your app. This page mirrors the installable skill at /skills/agenko/SKILL.md.
Install
Install with the Skills CLI (skills.sh) straight from these docs:
npx skills add https://docs.agenko.appOr from the repository:
npx skills add shuence/agenko-docs --skill agenkoOr copy the skill folder directly from the repo:
skills/agenko/SKILL.md
skills/agenko/reference.mdOr point the agent at this URL:
https://docs.agenko.app/skills/agenko/SKILL.mdThe skill is published from skills/agenko/ (the layout skills.sh discovers) and served by this site from /skills/agenko/. Well-known discovery is also live at /.well-known/agent-skills/index.json, so npx skills add https://docs.agenko.app works without GitHub. reference.md carries the env-var and endpoint tables so the main SKILL.md stays short.
Documentation workflow
Follow this order (same pattern as modern OSS docs platforms):
- Index — fetch
/llms.txtand scan section files (llms-docs.txt,llms-sdk.txt, …). - Best practices — read Best practices before adding spans or receipts.
- Page markdown — append
.mdto any path (/quickstart.md,/introduction.md). - Search — when unsure which page applies:
curl -sG "https://docs.agenko.app/api/search-docs" \
--data-urlencode "query=How do I gate delete_account?"- Verify in repo — OpenAPI at
agenko/spec/openapi/control-plane.yaml, conventions atagenko/spec/telemetry/semantic-conventions.yaml.
The contract
| Rule | Detail |
|---|---|
init() | Zero required args. Reads env. Never throws. Uninitialized = no-op. |
@check | Receipt after — claimed vs actual, verdict, hash chain. |
@approve | Gate before — when="irreversible" pauses; console inbox is human side. |
| Measurements | Hard facts on receipt only. Inferred signals → estimated: true. |
| Backlog | No why(), harness, or evals until Introduction status table says shipped. |
| OTEL | OpenInference + agenko.*. No proprietary wire format. |
Suggested system prompt
You are wiring Agenko — receipt after (@check), gate before (@approve).
Fetch https://docs.agenko.app/llms.txt and read /best-practices first.
Use agenko.init() with zero required args. Never throws.
Grounding scores: estimated: true always.
Python and TypeScript stay symmetric.
Search docs: GET /api/search-docs?query=...
Do not claim unshipped features.Where to look next
| Task | Page |
|---|---|
| What good instrumentation looks like | Best practices |
| First receipt in one minute | Quickstart |
| Env vars | Environment |
| OpenAI / LangGraph | Integrations |
| Self-host | Self-hosting |
| REST + OTLP | API reference |
UI search
Press ⌘K in the nav — same index as /api/search-docs, ranked excerpts only (not a live LLM). The copy buttons on each page give you the exact Markdown to paste into an agent.
Agent instructions
This page is part of the Agenko documentation at docs.agenko.app. Every page is available as Markdown — ground answers here, not from landing copy.
Querying these docs
- Full index: docs.agenko.app/llms.txt · sections: llms-docs.txt, llms-sdk.txt, llms-integrations.txt
- This page as markdown: docs.agenko.app/agent-skill.md
- Search API:
curl -sG "https://docs.agenko.app/api/search-docs" --data-urlencode "query=…"
Before writing SDK code
- Install the agent skill or read Agent skill
- Read Best practices — what a good receipt looks like
- Trust boundary:
@checkafter,@approvebefore init()— zero required args, never throws- Mark
estimated: trueuntil a check is a hard fact - Shipped vs backlog: Introduction status table