Home / Claude skills / Docs & writing / writing-for-agents

writing-for-agents

writing-for-agents is a Claude skill by mattpocock that writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.

Updated 2026-10-13

What is writing-for-agents?

writing-for-agents is a Claude skill by mattpocock that writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md. It is listed under Docs & writing and has 387,800 installs.

TypeClaude skill
Authormattpocock
Repositorymattpocock/skills
Popularity387,800 installs
CategoryDocs & writing
SecurityLow risk (100/100)
Rank#77 of 1,262 Claude skills; #8 in Docs & writing
SKILL.md length81 lines
LicenseMIT
Last commit2026-10-13
Stars this week+9,154

Is writing-for-agents safe to install?

writing-for-agents scores 100/100 on the MCPMods security check: Low risk. No checks raised a concern. It passed 9 of 9 checks.

Skill results come from a static scan of its SKILL.md for instruction overrides, hidden actions, risky commands and credential access.

CheckResult
No instruction-override phrasesPass
No hidden actionsPass
No pipe-to-shell installersPass
No obfuscated codePass
No destructive commandsPass
Doesn't ask for keys or credentialsPass
No network requestsPass
No shell commandsPass
Installs no packagesPass

How do I install writing-for-agents?

  1. Install with the skills CLI. Works for Claude Code and other agents that read skills.
    npx skills add https://github.com/mattpocock/skills --skill writing-for-agents
  2. Or copy it by hand. Claude Code loads any folder with a SKILL.md from ~/.claude/skills.
    git clone https://github.com/mattpocock/skills
    cp -r skills/skills/productivity/writing-for-agents ~/.claude/skills/writing-for-agents
  3. Use it. Claude loads the skill when a task matches its description. You can also name it in your prompt.
    Use the writing-for-agents skill to …

Or ask Claude to set it up

Paste this into Claude Code and it installs writing-for-agents for you:

Install the "writing-for-agents" skill from https://github.com/mattpocock/skills/tree/main/skills/productivity/writing-for-agents into ~/.claude/skills, then tell me in one line what it does.

More from mattpocock/skills

This repository has at least 9 Claude skills on MCPMods.

  • grill-me: A relentless interview to sharpen a plan or design. (Low risk)
  • grill-with-docs: A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go. (Low risk)
  • improve-codebase-architecture: Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you (Low risk)
  • tdd: Test-driven development. Use when the user wants to build features or fix bugs test-first, mentions "red-green-refactor" (Low risk)
  • setup-matt-pocock-skills: Configure this repo for the engineering skills: set up its issue tracker, triage label vocabulary, and domain doc layout (Low risk)
  • handoff: Compact the current conversation into a handoff document for another agent to pick up. (Low risk)
  • triage: Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write age (Low risk)
  • prototype: Build a throwaway prototype to answer a design question. Use when the user wants to sanity-check whether a state model o (Low risk)