Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add instructions/contentful/skills/agents-mdgit clone --depth 1 https://github.com/contentful/skillsWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.01145 | $0.01145 |
| Opus 5 | $0.00573 | $0.00573 |
| Sonnet 5 | $0.00229 | $0.00229 |
| Haiku 4.5 | $0.00114 | $0.00114 |
Grade A, and why
skills AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 119 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Contentful Skills
Agent-agnostic project conventions for the contentful/skills repository.
Repository Structure
skills/ Distributed to customers via `npx skills add contentful/skills`
.agents/skills/ Internal contributor skills — never distributed
.claude/skills Symlink to .agents/skills/ for Claude Code discovery
.claude-plugin/ Plugin marketplace configuration
skills/ is the distribution boundary. Only its contents are installed to customer environments. Everything outside (AGENTS.md, .agents/, .claude-plugin/) stays in the repo.
The skills CLI discovers skills recursively, so subdirectories work correctly. Most skills are organized in a flat structure directly under skills/ (e.g., skills/contentful-personalization/). Closely related skills can be grouped under a domain folder, such as skills/contentful-apps/.
Skill Requirements
Every skill needs at minimum:
SKILL.mdwith valid YAML frontmatter (name+description)package.jsonwith name and version
Even documentation-only skills require both files.
Naming Conventions
- Directory names: lowercase, hyphen-separated, prefixed with the domain (e.g.,
contentful-personalization,contentful-migration) namefield in SKILL.md frontmatter: must exactly match the immediate parent directory namepackage.jsonname:@contentful/skill-<skill-name>(e.g.,@contentful/skill-contentful-personalization)
Name Rules (agentskills.io spec)
- 1-64 characters
- Lowercase letters, numbers, and hyphens only
- Must not start or end with a hyphen
- Must not contain consecutive hyphens
- Must match the parent directory name
Creating a New Skill
Use the skill-authoring internal skill for guidance. It covers SKILL.md authoring, directory structure, package.json format, script conventions, naming rules, and review checklists.
For code skills with scripts, see skill-authoring's script conventions section.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago First seen · 119 lines · 1,145 tokens per session scan A 5cc072a39ade
skills AGENTS.md is an instructions file published in the GitHub repository contentful/skills (39 stars, last pushed 3d ago), licensed MIT. It adds 1,145 tokens to every session, about $0.0057 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other instructions, from other repositories
loom CLAUDE.md
Instructions for cosmix/loom, covering claude.md, project overview, build commands, architecture and source layout (loom/src/).
agentic-workflow CLAUDE.md
Instructions for gtrabanco/agentic-workflow, covering claude.md, repository layout, working rules, authoring a skill and hand off, don't compose across a model/effort boundary.
autovault CLAUDE.md
Instructions for autoworks-ai/autovault, covering claude.md, project, common commands, architecture and request flow.
agent-resources CLAUDE.md
Instructions for jcottam/agent-resources: See AGENTS.md for project conventions and contributing guidelines.
claude-for-strategy CLAUDE.md
Instructions for daddia/claude-for-strategy, covering claude.md, layout, validation — run before opening a pr, 2. json sanity and 3. consulting reference mirrors.
capgo-skills AGENTS.md
AGENTS.md instructions for Cap-go/capgo-skills, covering agents.md, quick start, install dependencies, build the plugin (typescript + rollup + docgen) and full verification (ios, android, web).