Agent Skills — open format (reference)
Educational routing only. This skill does not reproduce the specification. Use the canonical links below for authoritative text, schema details, and license terms.
Canonical URLs
| Resource | URL |
|---|---|
| Repository | github.com/agentskills/agentskills |
| Site | agentskills.io — documentation hub (per upstream README) |
The upstream project describes Agent Skills as a simple, open format: folders of instructions, scripts, and resources that agents can discover for task-specific expertise (“write once, use everywhere”). The repo holds the specification, documentation, reference SDK material, and pointers to example skills and community channels (e.g. Discord — see live README).
Documentation index (llms.txt)
Use agentskills.io/llms.txt as the machine-readable index of first-party docs (discover pages before deep-linking). It currently lists:
| Doc | URL |
|---|---|
| Overview | agentskills.io/home.md — open format for agent capabilities and expertise |
| What are skills? | agentskills.io/what-are-skills.md — lightweight format for specialized knowledge and workflows |
| Specification | agentskills.io/specification.md — complete format specification |
| Integrate skills into your agent | agentskills.io/integrate-skills.md — adding Agent Skills support to an agent or tool |
What to read there
| Area | Typical use |
|---|---|
| Specification | specification.md — exact format expectations for portable skills |
| Integration | integrate-skills.md — agent/tool implementers |
| Documentation | home.md, what-are-skills.md — concepts |
| Example skills | Patterns and breadth (see GitHub README + examples) |
| Contributing | CONTRIBUTING.md in-repo |
License (summary)
Upstream states: code in the repository is under Apache-2.0; documentation under CC-BY-4.0 — confirm in-repo LICENSE and per-directory notices. The format is community-open; Anthropic is named as a maintainer in the public README.
How to combine with blockint
| Need | Skill |
|---|---|
| This repo’s BI / chain-focused skills | blockchain-intelligence-playbook |
| Portable skill format vs domain content | agentskills-specification (upstream spec); topical skills here for blockchain intel |
Guardrails
- Upstream wins — If blockint layout ever diverges from the published spec, treat agentskills as the portability reference.
- No credential paste — Spec work does not require embedding secrets in skills.
Goal: stable pointers to agentskills/agentskills, agentskills.io/llms.txt, and agentskills.io/specification.md for Agent Skills format and documentation alignment.