Docs & writing
16,892 rows from 3,895 repositories
Prose as the deliverable, whether it ships to users or to the next maintainer.
- Technical documentation485
- READMEs & changelogs924
- API reference467
- Content writing634
- Editing & proofreading223
- Translation & localisation848
What Docs & writing skills agree on
3,030 skill files read, by 1,951 of the 3,904 authors on this shelf whose files we hold, 2026-09-06
The middle one of the 377 measured here is ~1.6k tokens long, counted with cl100k_base
Counted by distinct author, so one author publishing three of these counts once. Where a claim sits in fewer files than authors, that is said: a claim held by forty authors across three files is one file people copied, not forty people who agreed. Near-identical wordings are grouped and the other wordings are shown, so the grouping is yours to check.
What they tell the agent to do
- Use third-person for skill descriptions54 of 1951 in 35 filesalso worded as use third-person perspective for skill descriptions; use third person for skill descriptions
- Start descriptions with Use when43 of 1951 in 29 filesalso worded as Start description with Use when; start descriptions with Use when or How to
- Run baseline scenarios before writing any skill40 of 1951 in 26 filesalso worded as run baseline scenarios before writing the skill; observe baseline failure before writing any skill
- Use active voice40 of 1951 in 36 filesalso worded as Use the active voice; Use active voice for every sentence
- Map file responsibilities before defining tasks36 of 1951 in 29 filesalso worded as map out file responsibilities before defining tasks; map out files and responsibilities before defining tasks
- Use checkbox syntax for tracking steps35 of 1951 in 27 filesalso worded as Use checkbox syntax for tracking tasks; Use checkbox syntax for tracking
- Ask one question at a time35 of 1951also worded as Ask questions one at a time; Ask clarifying questions one at a time
- Offer execution options after saving the plan33 of 1951 in 24 filesalso worded as Offer execution choices after saving the plan; Offer execution options after saving
- Include complete code in every step33 of 1951 in 27 filesalso worded as include actual code and commands in every step; include actual code for every step
- Design units with clear boundaries and interfaces31 of 1951 in 23 filesalso worded as Design units with clear boundaries; design units with clear boundaries and defined interfaces
- Announce the skill usage at the start30 of 1951also worded as Announce skill usage at start; Announce skill usage at the start
- Verify agent compliance after adding the skill29 of 1951 in 17 filesalso worded as verify agent compliance after writing the skill; verify compliance after writing the skill
- Announce plan creation at the start27 of 1951 in 18 filesalso worded as announce plan creation at start; announce plan generation at the start
- Use kebab-case for skill names27 of 1951 in 22 filesalso worded as use kebab-case for new file names; Use kebab-case for the filename
- Apply test-driven development to process documentation26 of 1951 in 16 filesalso worded as apply test-driven development to documentation; apply test-driven development to procedure documentation
What they tell it not to do
- Do not overwrite existing files60 of 1951also worded as do not overwrite existing documentation; do not silently overwrite existing files
- Do not use placeholders like TBD or TODO49 of 1951 in 44 filesalso worded as Do not use placeholders like TODO or TBD; do not use TBD or TODO placeholders
- Do not use em dashes49 of 1951also worded as Do not use em-dashes; Do not use em or en dashes
- Do not summarize the skill process in the description40 of 1951 in 26 filesalso worded as do not summarize skill workflows in the description; do not summarize skill workflow in the description
- Do not include narrative storytelling39 of 1951 in 28 filesalso worded as do not use narrative examples; do not include narrative storytelling in skills
- Do not create skills for one-off solutions35 of 1951 in 24 filesalso worded as do not create one-off solutions; do not use skills for one-off tasks
- Do not use @ links to reference other skills34 of 1951 in 22 filesalso worded as do not use @ to link skills; do not use @ links to other skills
- Do not include implementation details in the glossary34 of 1951 in 32 filesalso worded as do not document implementation details; do not include implementation details in glossary
- Do not skip testing for simple additions32 of 1951 in 22 filesalso worded as do not skip testing for minor updates; do not skip testing for any reason
- Do not reference undefined types or functions29 of 1951 in 23 filesalso worded as Do not reference undefined functions or methods; do not use references to undefined types or functions
What they expect to be installed
- git375 of 1951
- grep181 of 1951
- python3111 of 1951
- gh93 of 1951
- bash93 of 1951
- python81 of 1951
- curl78 of 1951 in 76 files
- pytest75 of 1951 in 66 files
- Read75 of 1951
- AskUserQuestion69 of 1951
What they ask it to produce
- Markdown file155 of 1951 in 154 filesalso worded as markdown files; Markdown report
- SKILL.md106 of 1951 in 83 filesalso worded as SKILL.md file; skill
- Updated documentation files92 of 1951 in 88 filesalso worded as updated documentation; updated documentation pages
- Implementation plan markdown file61 of 1951 in 50 filesalso worded as implementation plan file; markdown implementation plan file
- README.md61 of 1951 in 59 filesalso worded as README; Updated README.md
- CLAUDE.md49 of 1951 in 44 filesalso worded as Updated CLAUDE.md; CLAUDE.local.md
- Documentation48 of 1951 in 41 filesalso worded as Technical documentation; documentation files
- report.md42 of 1951also worded as research.md; review.md
When Docs & writing authors say to reach for one
The situations these authors wrote into their own files, counted out of the same 1,951 authors, with the skills that name each one
- User requests a report43 of 1951 in 39 files
- When spec or requirements exist for multi-step tasks40 of 1951 in 30 files
- Writing plans
- Workflow superpowers writing plans
- Superpowers writing plans
- and 37 more on this shelf
- Technique is not intuitively obvious37 of 1951 in 23 files
- Others would benefit from the technique31 of 1951 in 18 files
- Pattern applies broadly across projects29 of 1951 in 17 files
- Create a skill29 of 1951 in 25 files
- User requests a feature29 of 1951
- Story craftsman
- Cc docs
- Issue writer
- and 1 more on this shelf
- Writing documentation27 of 1951 in 26 files
How Docs & writing skills are built
15,539 skill directories by 3,361 authors, read from their repositories’ own file trees 2026-08-05
The middle bundle among those shipping files is 3 files, 15.9 KB beside SKILL.md
Counted by distinct author, same as above, so one author publishing forty template copies counts once. SKILL.md itself is not counted as a file, so a single-file skill is one where that file is the whole skill.
The shape
- SKILL.md is the whole skill1,037 of 3,361 authors, 7,149 of 15,539 skills
- files ship beside it2,324 of 3,361 authors, 8,390 of 15,539 skills
- executable scripts ship inside993 of 3,361 authors, 2,473 of 15,539 skills
The folders they converge on
- references/1,477 of 3,361 authors, 4,289 of 15,539 skills
- scripts/815 of 3,361 authors, 2,053 of 15,539 skills
- agents/465 of 3,361 authors, 1,090 of 15,539 skills
- assets/392 of 3,361 authors, 830 of 15,539 skills
- examples/259 of 3,361 authors, 482 of 15,539 skills
- templates/235 of 3,361 authors, 394 of 15,539 skills
nexu-io/open-design/.claude/skills/od-contribute Skill
85,608★ repo🎨 The open-source Claude Design alternative. 🖥️ Local-first desktop app. 🖼️ Your coding agent becomes the design engine: prototypes, landing pages, dashboards, slides, images & video — real files, HTML/PDF/PPTX/MP4 export. 🤖 Claude Code / Codex / Cursor / Gemini / OpenCode / Qwen & 20+ CLIs via BYOK.
alirezarezvani/claude-skills/.gemini/skills/README Skill
24,478★ repo345 Claude Code skills & agent skills & plugins (30+ Agents, 70+ custom commands, 330+ skills, customizable references, scripts)for Claude Code, Codex, Gemini CLI, Cursor, and 8 more coding agents — engineering, marketing, product, compliance, C-level advisory, research, business operations, commercial & finance, and your daily productivity skills.
eigent-ai/eigent/resources/example-skills/docx Skill
15,013★ repoEigent: The Open Source Cowork Desktop - Local and Free Alternative to Claude Cowork and Codex
nidhinjs/prompt-master Skill
11,108★A Claude skill that writes the accurate prompts for any AI tool. Zero tokens or credits wasted. Full context and memory retention
Agents365-ai/drawio-skill/docs Skill
7,583★ repoGenerate draw.io diagrams from natural language — 11 presets (UML, SysML/MBSE, BPMN, network, C4…), 36 tools: codebase/CI/infra-to-diagram, image→editable diagram, mind maps, build-up animation, exec-view compression, click-through runbooks, PR diff bot. Vision self-check, 10,000+ shapes. Exports PNG/SVG/PDF/JPG.
inkeep/open-knowledge/packages/server/assets/skills/bug-report Skill
3,424★ repoBeautiful, AI-native markdown IDE and LLM wiki
open-gitagent/opengap/examples/full/skills/document-review Skill
2,907★ repoA framework-agnostic, git-native standard for defining AI agents
first-fluke/oh-my-agent/.agents/skills/oma-academic-writer Skill
1,226★ repoPortable, vendor-agnostic agent harness for project-specific skills, workflows, and agent teams aligned with your codebase, conventions, and engineering standards.
amElnagdy/guard-skills/skills/clean-code-guard Skill
1,154★ repoGuard skills for coding agents, quality gates that catch AI-generated failure modes in code, tests, and docs
lout33/symbiotic-ai/skills/symbiotic-onboard Skill
no license733★ repoA symbiotic AI agent that remembers everything, challenges you, and extends your cognition.
dongshuyan/compass-skills/skills/academic-humanizer Skill
680★ repo司南:个性化 AI 任务总控 Skills 系统 /COMPASS: Personal Alignment Skills OS for AI Agents
917Dhj/DeepPaperNote/skills/deeppapernote Skill
591★ repoDeepPaperNote is an agent skill for deep-reading a single paper and generating high-quality Obsidian-style research notes. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
zscole/adversarial-spec/skills/adversarial-spec Skill
553★ repoA Claude Code plugin that iteratively refines product specifications by debating between multiple LLMs until all models reach consensus.
levnikolaevich/claude-code-skills/plugins/codebase-audit-suite/skills/ln-21-documentation-auditor Skill
535★ repo18 standalone skills for Claude Code and Codex: review, audit, optimization, testing, product discovery, and safe repository publishing.
hanlulong/econ-writing-skill/skills/econ-write Skill
529★ repoAgent Skill that transforms AI assistants into expert economics paper writers. Synthesizes 50+ guides by Cochrane, McCloskey, Shapiro, Head, Bellemare, Goldin, Kremer. Compatible with Claude Code and OpenAI Codex.
oliver-kriska/claude-elixir-phoenix/.claude/skills/cc-changelog Skill
517★ repoClaude Code plugin for Elixir/Phoenix/LiveView — 20 specialist agents, Iron Laws enforcement, and Tidewave MCP integration. Plan features with parallel research agents, execute with automatic verification, review with 4-agent parallel audits, and capture learnings as reusable knowledge.
malob/nix-config/configs/claude/plugins/ai-sdk/skills/ai-sdk-docs Skill
459★ repoMy Nix system configs!
YurunChen/repo-docs-skills/docs Skill
no license447★ repoLiving project docs for coding agents: keep guides, progress logs, change maps, and handoff context updated as your repo evolves.
tizzy916/humanities-writing-companion Skill
no license357★End-to-end humanities writing assistant — an Agent Skill (open SKILL.md format). 11 modes from Socratic research-question sharpening through AI-use disclosure. Bilingual (EN/中文), discipline-aware (literature/history/philosophy/art/religion/linguistics + cross-disciplinary). Four-layer critique, calibratable devils advocate, voice preservation.
andrea9293/mcp-documentation-server/io.github.andrea9293/mcp-documentation-server MCP server
341★ repoLocal-first document management and semantic search for AI coding agents
datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction/1_DDC_Toolkit/Analytics/daily-progress-report Skill
276★ repo221 AI skills for construction: BIM analysis, cost estimation, scheduling, document control, and automation with Claude Code
modu-ai/cowork-plugins/moai-bi/skills/executive-summary Skill
268★ repo모두의 AI (MoAI) — Claude Cowork & Claude Code 한국 실무 도메인 AI 하네스·플러그인 마켓플레이스. 사업계획서·세무·법률·HR·마케팅·커머스·BI·콘텐츠 도메인 스킬·에이전트·워크플로우. Korean B2B + office docs (HWPX/DOCX/XLSX/PPTX/PDF) + AI media (image/video/voice). AI-slop 검수 + humanize-korean 내장.
loulanyue/awesome-claude-notes/.cursor/skills/article-writing Skill
264★ repoCommunity-maintained distribution of reusable AI coding agents, commands, skills, hooks, and cross-harness workflows.
bowenliang123/markdown-exporter Skill
261★An Agent Skill and Dify plugin to transform Markdown to files of DOCX, PPTX, XLSX, PNG, PDF, Mermaid, HTML, MD, CSV, JSON, XML.
majiayu000/spellbook/plugins/rust-dev/skills/rust-best-practices Skill
260★ repoCross-runtime skills for Claude Code, Codex, and multi-agent workflows.
scaccogatto/okf-skills/skills/okf Skill
257★ repoThe OKF toolkit for Claude Code — author, maintain, validate & visualize Open Knowledge Format bundles. Claude Code plugin + skills.sh.
leemysw/feishu-docx/.skills/feishu-docx Skill
247★ repo🚀 Feishu/Lark Docs、Sheet、Bitable <-> Markdown | AI Agent-friendly knowledge base exporter and writer with OAuth 2.0, CLI, TUI & Claude Skills support - 飞书文档 <写入/导出> Markdown | AI Agent 友好型导出-写入工具
yonatangross/orchestkit/io.github.yonatangross/orchestkit MCP server
218★ repoRead-only MCP server for the OrchestKit docs: full-text search + Markdown fetch. No auth.
marianfoo/mcp-sap-docs/io.github.marianfoo/mcp-sap-docs MCP server
213★ repoFast MCP server for unified SAP docs search (SAPUI5, CAP, OpenUI5, wdi5) with BM25 full-text search
KaguraNanaga/document-format-skills Skill
211★Professional Word document formatting toolkit for Chinese documents
AIDevGTM/gtm-cofounder/skills/00-start-here Skill
209★ repoThe GTM co-founder you don't have. Open-source GTM Agent Skills for technical AI/dev-tool founders building alone: positioning, first users, launch, pricing. Built from real dev-tool GTM experience, sharpened by Frankl & Czakon. MIT.
golbin/agent-skills/skills/prd Skill
no license209★ repoReusable agent skills for Codex and compatible tools
skrun-dev/skrun/agents/adr-writer Skill
208★ repoDeploy any Agent Skill as an API via POST /run. The open-source multi-model alternative to Claude Managed Agents, Microsoft Foundry & Mistral/Koyeb — works with any LLM.
Idun-Group/idun-agent-platform/examples/tutorials/text-to-sql-deep-agent/skills/query-writing Skill
198★ repo🟪 Open-source runtime that ships any LangGraph or Google ADK agent as a production-ready FastAPI service. Bundled , AG-UI copilotkit API, chat UI, 15+ guardrails, MCP, OpenTelemetry, OIDC. One pip install. Self-hosted, no vendor lock-in.
bevibing/socrates-skill Skill
197★Socratic method teaching skill for Claude Code — guides users to discover answers through questioning
testdouble/han/.claude/skills/han-release Skill
195★ repoHan: AI skills and agents for "Solo" product engineers and small teams
Amal-David/pagecast/.codex/skills/publish-report Skill
186★ repoPublish HTML, Markdown and static mini apps to shareable Cloudflare Pages URLs from the terminal or coding agents.
techygarg/lattice/dev-skills/skill-align Skill
176★ repoInstall engineering discipline into any AI coding assistant. Composable skills for design, implementation, review, and team standards. Better process, not just better prompts.
Frappucc1no/recall-loom/skills/recallloom Skill
153★ repoProject memory for long-running AI work across agents, models, and sessions. Keep context, decisions, progress, and next steps in local project files.
dog-qiuqiu/invincat/invincat_cli/built_in_skills/docx Skill
153★ repoA native Python agent CLI built on DeepAgents CLI, featuring an independent memory Agent that captures learnings after each task and delivers efficient AI coding assistance through hierarchical memory management.
danjdewhurst/story-skills/skills/chapter-writing Skill
149★ repoAgent Skills for end-to-end story writing in markdown, packaged as Codex and Claude Code plugins.
DaleSeo/korean-skills/skills/grammar-checker Skill
129★ repo🇰🇷 Korean language skills for AI agents
JuneYaooo/xhs-writer-skill Skill
125★小红书爆款笔记生成器,基于gpt-image-2,强力超快生成,自然语言修改,超好用!
serradura/okf-gem/okf/lib/okf/skill Skill
120★ repoOpen Knowledge Format for coding agents. Author, validate, lint, search, and visualize portable Markdown knowledge bundles. One gem carries the agent skill, the CLI and Ruby library, and an interactive graph. Docker and Claude Code plugin included, 100% local.
AltimateAI/data-engineering-skills/skills/altimate-code Skill
118★ repoSkills related to Data Engineering Work for Claude Code
frumu-ai/tandem/ac.tandem/docs-mcp MCP server
no license114★ repoRemote MCP server for Tandem docs, install guides, SDKs, workflows, and agent setup help.
zaferayan/skills Skill
no license113★Expo mobile app development skill for Claude Code
Social media caption generator claude
rediumvex/social-media-caption-generator-claude Skill
105★Social media caption generator as a Claude skill — turn any text, script, or screenshot into ready-to-post captions for Instagram Reels, Carousel, TikTok, Threads, Facebook, YouTube Shorts. Algorithm-optimized for shares, saves, and completion rate. Built by @theromanknox (280K+ IG).
neo4j-contrib/neo4j-skills/neo4j-agent-memory-skill Skill
101★ repoNeo4j Skills for Coding and other Agents including Cypher
HoraceLuBFA/en-zh-translation-polish Skill
98★英译汉翻译润色 · English→Chinese translate & polish skill (英中对照)
Unreal Engine API Documentation
Codeturion/unreal-api-mcp/io.github.Codeturion/unreal-api-mcp MCP server
92★ repoAccurate UE5 C++ API docs for AI agents. Prevents hallucinated signatures and includes.
aws-samples/sample-strands-agents-agentskills/docs Skill
90★ repoAgent Skills implementation for Strands Agents SDK
deepklarity/harness-kit/.claude/skills/fable-audit Skill
89★ repoA kit for building with AI agents and also the engineering patterns around it.
CesiumGS/cesium-ai-integrations/.github/skills/cesium-context7 Skill
86★ repoCesium AI Integrations is a collection of reference integrations and experiments connecting the Cesium ecosystem with AI systems including Model Context Protocol (MCP) tools, retrieval pipelines, and agent skills.
myunwang/ppt-report-skills Skill
85★A Claude Code skill for web report decks — richer ECharts charts, one file per slide (edit one page, save tokens), and complex structure diagrams. 16:9 & vertical, PDF/image export.网页版 PPT 汇报的 Claude Code skill:ECharts 把数据画得更好看、每页一个文件改一页省 token、能做复杂结构图(架构/框架/价值链)。16:9 + 竖屏,导出 PDF 和图片
foryourhealth111-pixel/research-innovation-explorer Skill
85★The automated approach leverages the cross-combination of high-quality papers from top conferences to uncover feasible research and innovation ideas. Through multi-level verification and convergence screening, it identifies research schemes that are feasible and have in-depth value.
paleo/alignfirst/.agents/skills/sharp-writing Skill
84★ repoCompanion products for AI-assisted software work.
mturac/promptguard/skills/promptguard Skill
82★ repoOffline prompt-contract auditor for Hermes, Claude Code, Codex, OpenCode & OpenClaw. Pre-write guard before agents ship vague code. Zero deps. No model API.
claude-world/director-mode-lite/.claude/skills/changelog-observer Skill
81★ repoUse Claude Code like a Director, not a Programmer. MIT toolkit with Auto-Loop, guided setup, 27 commands, 14 agents, and 32 skills.
risingwavelabs/box0 Skill
81★Open-Source Platform for Subagents and Agent Teams. Long-running, collaborative, proactive.