Agent skill · Documentation

writing-skills

Use when creating, updating, or improving agent skills.

Nick44,086★ · +407/wk · 1 repos on radarProfile →
claude-codecodexcursorships scriptsMIT
Install
npx skills add sickn33/agentic-awesome-skills --skill writing-skills --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 21
SKILL.md size: 4 KB
Bundled scripts: yes
Path: skills/writing-skills/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 44,414 · +328 this week
Language: Python
Read our review of the source →

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# Writing Skills (Excellence) Dispatcher for skill creation excellence. Use the decision tree below to find the right template and standards. ## ⚡ Quick Decision Tree ### What do you need to do? 1. **Create a NEW skill:** - Is it simple (single file, <200 lines)? → [Tier 1 Architecture](references/tier-1-simple/README.md) - Is it complex (multi-concept, 200-1000 lines)? → [Tier 2 Architecture](references/tier-2-expanded/README.md) - Is it a massive platform (10+ products, AWS, Convex)? → [Tier 3 Architecture](references/tier-3-platform/README.md) 2. **Improve an EXISTING skill:** - Fix "it's too long" -> [Modularize (Tier 3)](references/templates/tier-3-platform.md) - Fix "AI ignores rules" -> [Anti-Rationalization](references/anti-rationalization/README.md) - Fix "users can't find it" -> [CSO (Search Optimization)](references/cso/README.md) 3. **Verify Compliance:** - Check metadata/naming -> [Standards](references/standards/README.md) - Add tests -> [Testing Guide](references/testing/README.md) ## 📚 Component Index | Component | Purpose | |-----------|---------| | **[CSO](references/cso/README.md)** | "SEO for LLMs". How to write descriptions that trigger. | | **[Standards](refe

What's inside
Steps it walks through
  1. ⚡ Quick Decision Tree
  2. What do you need to do?
  3. 📚 Component Index
  4. 🛠️ Templates
  5. When to Use
  6. How It Works
  7. Quick Example
  8. Common Mistakes
  9. ✅ Pre-Deploy Checklist
  10. 🔗 Related Skills
  11. Examples
  12. Limitations
Ships with 20 files
  • anthropic-best-practices.md
  • examples.md
  • gotchas.md
  • graphviz-conventions.dot
  • persuasion-principles.md
  • references/anti-rationalization/README.md
  • references/cso/README.md
  • references/standards/README.md
  • references/standards/metadata-standard.md
  • references/templates/discipline.md
  • references/templates/pattern.md
  • references/templates/reference.md
  • references/templates/technique.md
  • references/templates/tier-3-platform.md
  • references/testing/README.md
  • references/tier-1-simple/README.md
  • references/tier-2-expanded/README.md
  • references/tier-3-platform/README.md
  • render-graphs.js
  • testing-skills-with-subagents.md
Commands it runs
mkdir -p ~/.config/opencode/skills/my-technique
touch ~/.config/opencode/skills/my-technique/SKILL.md
mkdir -p ~/.config/opencode/skills/my-skill/references/core
touch ~/.config/opencode/skills/my-skill/{SKILL.md,gotchas.md}
touch ~/.config/opencode/skills/my-skill/references/core/README.md
More from agentic-awesome-skills
All skills →
About this skill
What does the writing-skills skill do?

Use when creating, updating, or improving agent skills.

How do I install it?

Run `npx skills add sickn33/agentic-awesome-skills --skill writing-skills --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From sickn33/agentic-awesome-skills, a repository with 44,414 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going