agentsclimarketplace
Sign in

Shelves Docs & writing

READMEs & changelogs

924 rows from 504 repositories

The files at the root of a repository that decide whether anyone stays.

What READMEs & changelogs skills agree on

472 skill files read, by 446 of the 460 authors on this shelf whose files we hold, 2026-09-06

The middle one of the 60 measured here is 903 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

  1. Follow Keep a Changelog format24 of 446also worded as Follow the Keep a Changelog format; follow the Keep a Changelog section order
  2. Collect commits since the last git tag15 of 446 in 13 filesalso worded as List commits since the last tag; collect commits since the last release
  3. Omit empty sections14 of 446also worded as Omit sections with no entries; Omit empty categories
  4. Put breaking changes first with migration steps14 of 446also worded as Identify breaking changes and migration steps; Prepend breaking-change warning and migration steps
  5. Include migration guidance for breaking changes11 of 446 in 10 filesalso worded as Give exact migration steps for breaking changes; Write migration guides for every breaking change
  6. Categorize commits by conventional commit prefix11 of 446also worded as Classify every commit by conventional prefix; categorize commits into changelog sections by prefix
  7. Mark breaking changes prominently10 of 446also worded as Flag breaking changes prominently; Mark breaking changes with a Breaking label
  8. Prepend the new entry to CHANGELOG.md9 of 446also worded as Prepend a new section above the previous changelog entry; Prepend new entries to CHANGELOG.md
  9. Highlight breaking changes with migration notes8 of 446 in 7 filesalso worded as Include migration notes for breaking changes; Place breaking changes under Changed with migration notes
  10. Classify changes into Keep a Changelog categories8 of 446 in 7 filesalso worded as Categorize commits into Keep a Changelog types; Categorize into Keep a Changelog sections
  11. Group related commits into single entries8 of 446also worded as Merge related commits into single entries; Group related commits into user-facing entries
  12. Write the changelog from commits8 of 446also worded as Generate a changelog draft from the commit stream; commit changelog entries with the work they describe
  13. Tag and push the release commit8 of 446also worded as Tag the release and push tags; Create and push a release git tag
  14. Categorize commits into changelog sections8 of 446also worded as Categorise commits into Keep a Changelog sections; Categorize commits by prefix into changelog categories
  15. Categorize changes into features, improvements, fixes8 of 446also worded as Categorize changes as Added, Changed, Fixed, etc.; categorize changes as features, fixes, performance, documentation

What they tell it not to do

  1. Never rewrite existing changelog entries16 of 446 in 15 filesalso worded as Don't rewrite changelog entries retroactively; rewriting existing changelog entries
  2. Do not commit or push15 of 446also worded as Do not commit, tag, or push; Do not commit or tag
  3. Never use em dashes10 of 446also worded as Never use literal em dash characters; Do not use em-dashes.
  4. Do not use internal jargon or file names in entries10 of 446 in 9 filesalso worded as Do not use internal jargon; No internal jargon or file names in entries
  5. Never include internal-only refactors, tests, or CI changes9 of 446also worded as including internal commits like refactors and tests; Do not include refactors, dependency bumps, or CI changes
  6. Never stage with git add -A8 of 446also worded as Never use git add -A; staging with git add .
  7. Do not write without explicit user approval8 of 446also worded as Never apply changes without explicit user approval; Never write the file without explicit approval
  8. Never paste raw commit messages as changelog entries7 of 446 in 6 filesalso worded as Write commit messages as changelog entries; Never invent changelog entries without a real commit
  9. Do not include chore, build, ci commits unless user-facing7 of 446also worded as Including chore, ci, build, style, test commits unless user-visible; Do not include docs, style, test, or chore commits
  10. Never use the Write tool on CHANGELOG.md7 of 446also worded as Never write CHANGELOG.md without explicit --apply; Never overwrite CHANGELOG with the Write tool

What they expect to be installed

  1. git131 of 446
  2. git log61 of 446 in 60 files
  3. gh54 of 446
  4. grep39 of 446
  5. AskUserQuestion22 of 446
  6. python318 of 446
  7. git diff16 of 446
  8. Bash16 of 446
  9. jq16 of 446
  10. Glob15 of 446

What they ask it to produce

  1. CHANGELOG.md82 of 446also worded as Updated CHANGELOG.md; CHANGELOG.md entry
  2. README.md59 of 446 in 58 filesalso worded as README; updated README.md
  3. Changelog entry44 of 446 in 42 filesalso worded as CHANGELOG; changelog entries
  4. GitHub release24 of 446also worded as GitHub release with notes; GitHub release body
  5. Release notes23 of 446 in 21 filesalso worded as release notes document; RELEASE_NOTES.md
  6. Release notes markdown file21 of 446also worded as Markdown release notes; markdown release notes document
  7. Markdown changelog20 of 446 in 19 filesalso worded as Markdown changelog entry; Markdown changelog article in output/articles
  8. Annotated git tag17 of 446also worded as annotated version tag; git tag

When READMEs & changelogs authors say to reach for one

The situations these authors wrote into their own files, counted out of the same 446 authors, with the skills that name each one

How READMEs & changelogs skills are built

835 skill directories by 468 authors, read from their repositories’ own file trees 2026-08-05

The middle bundle among those shipping files is 2 files, 10.7 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

  1. SKILL.md is the whole skill206 of 468 authors, 407 of 835 skills
  2. files ship beside it262 of 468 authors, 428 of 835 skills
  3. executable scripts ship inside87 of 468 authors, 128 of 835 skills

The folders they converge on

  1. references/149 of 468 authors, 204 of 835 skills
  2. scripts/80 of 468 authors, 115 of 835 skills
  3. agents/50 of 468 authors, 60 of 835 skills
  4. assets/33 of 468 authors, 37 of 835 skills
  5. evals/31 of 468 authors, 35 of 835 skills
  6. examples/15 of 468 authors, 19 of 835 skills

  • README

    alirezarezvani/claude-skills/.gemini/skills/README Skill

    24,478★ repo

    345 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.

  • Cc changelog

    oliver-kriska/claude-elixir-phoenix/.claude/skills/cc-changelog Skill

    517★ repo

    Claude 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.

  • Han release

    testdouble/han/.claude/skills/han-release Skill

    195★ repo

    Han: AI skills and agents for "Solo" product engineers and small teams

  • Changelog observer

    claude-world/director-mode-lite/.claude/skills/changelog-observer Skill

    81★ repo

    Use Claude Code like a Director, not a Programmer. MIT toolkit with Auto-Loop, guided setup, 27 commands, 14 agents, and 32 skills.

  • Docs claim check

    kyungseo/skillstead/skills/docs-claim-check Skill

    71★ repo

    Practical, portable skills for agentic coding workflows — clearer diagrams, checked claims, safer GitHub releases, natural EN↔KO writing.

  • General readme skill

    KieranGao/general-readme-skill Skill

    58★

    使用 AI 编程助手为任意项目生成专业美化的 README 文件 Generate Professional & Beautified README Files For Any Project Using AI Assistants Skill.

  • Readme generator

    geekjourneyx/readme-generator Skill

    40★

    Generate professional README.md with 16:9 infographics, SEO-optimized metadata, and structured author sections — powered by Playwright and AI agent skills

  • Good readme

    evilmartians/agent-skills/skills/good-readme Skill

    30★ repo

    Production-grade Agent Skills from Evil Martians — drop-in expertise for your AI coding agent

  • Changelog writer

    ommakes/Skills/changelog-writer Skill

    21★ repo

    Skills for product design

  • Craft repository readme

    rfdiosuao/AgentSkill/craft-repository-readme Skill

    16★ repo

    可复用的 OpenClaw、Codex 与 AI Agent Skill 工具箱，附安装、验证和发布工作流

  • Delivery discipline

    th3vib3coder/vibe-science/.claude/skills/delivery-discipline Skill

    15★ repo

    Adversarial agent loops for verifiable vibe researching. Claude Code plugin. Falsification-first, not production-first.

  • Doc standards

    JuanMarchetto/doc-standards-skill/doc-standards Skill

    13★ repo

    Claude Code skill: five-layer documentation quality standards (ASD-STE100, Google/Microsoft style, ISO 24495, AI readability) with a machine-checkable lint gate

  • Changelog

    huzaifa525/claude-code-optimizer/templates/.claude/skills/changelog Skill

    9★ repo

    Optimize Claude Code token usage — 22 skills, 8 hooks, 6 rules. One npm install. Zero manual steps. Cut costs by 67%.

  • Ceres publish dataset

    AndreaBozzo/Ceres-Claude-Skill/ceres-publish-dataset Skill

    no license7★ repo

    Claude Code Skill for Ceres

  • Code to content

    arome3/code-to-content/skills/code-to-content Skill

    6★ repo

    Claude Code skill that transforms codebases into developer content. 5-phase gated workflow, 3 specialized agents, 13 slash commands. Generate blog posts, tutorials, Twitter threads, LinkedIn posts, READMEs, newsletters, video scripts, and conference talks—all grounded in actual code.

  • Changelog

    tuliosousapro/SaaS-blueprint/skills/changelog Skill

    4★ repo

    BRAINIAC - SaaS Blueprint, NOT an APP. It's a comprehensive playbook and operating system designed for building, launching, and scaling a SaaS APP covering from MVP to Mass Scale. It is structured as a chronological and functional roadmap, containing over 80 specialized directories, each with its own PLAYBOOK.md.

  • Wbg oss review

    worldbank/open-source-kit/.github/skills/wbg-oss-review Skill

    4★ repo

    Reusable GitHub Actions workflow and Copilot skill for World Bank open source compliance.

  • Business process automation

    VersoXBT/claude-recommended-skills/business-process-automation Skill

    3★ repo

    9 Claude Code skills recommended by Anthropic team — production-ready skills for code review, CI/CD, debugging, scaffolding, data analysis, infrastructure ops, and more. Based on 'Lessons from Building Claude Code' by Thariq @ Anthropic.

  • Cc changelog

    zeikar/hyperclaude/.claude/skills/cc-changelog Skill

    3★ repo

    Claude Code plugin: Claude builds, Codex critiques — a gated research → plan → review → ship pipeline, with autonomous multi-agent revise loops that self-converge.

  • Comment cleanup

    ezzatmakar/ai-code-skills/skills/comment-cleanup Skill

    3★ repo

    Agent Skills for Claude Code, Codex & OpenCode that review code for security, performance & clean code — Next.js & Laravel PR reviewers plus a stack-agnostic pre-push reviewer with a Pass/Warn/Fail scorecard.

  • Open source

    igarbayo/open-source Skill

    2★

    Skill para agentes (Claude Code, OpenCode) que genera la gobernanza open source completa de un proyecto: README, LICENSE, REUSE/SPDX, CONTRIBUTING y más. Válida para cualquier proyecto o hackathon.

  • Cutting a release

    gustavo-meilus/aiboarding/.claude/skills/cutting-a-release Skill

    2★ repo

    Keep AGENTS.md alive: generate, compress, audit, and update AI-agent onboarding for Claude Code, Codex, Copilot, Cursor, and OpenCode.

  • Release notes

    kangminhyuk1111/agents/skills/release-notes Skill

    no license2★ repo

    Drop-in skills that supercharge your AI coding agent — just add SKILL.md and go

  • Minimal skill

    ucsahinn/ai-skill-create/examples/minimal-skill Skill

    2★ repo

    AI Skill Create: toolkit for creating, validating, testing, and packaging reusable AI agent skills and Codex skills.

  • Changelog

    TeamDzX/myllm-skills/skills/changelog Skill

    2★ repo

    Curated open Agent-Skill format skills for MyLLM (the on-device iOS AI agent). Install with /skill add teamdzx/myllm-skills.

  • Common changelog

    octivi/skills/common-changelog Skill

    1★ repo

    Public repository for AI Agent Skills

  • Readme generator

    landim32/awesome-ai-skills/skills/readme-generator Skill

    1★ repo

    Claude AI Skills repository

  • Changelog manager

    datamaker-kr/synapse-claude-marketplace/dist/opencode/platform-dev-team-common/.opencode/skills/changelog-manager Skill

    no license1★ repo

    시냅스 제품군 개발을 위한 공용 Claude Marketplace 입니다. 용도 및 목적 별 plugins 를 통해 claude plugins, agents, skills, commands 를 제공합니다.

  • Ai video agency magnific

    ki-stuff/ai-video-agency-magnific Skill

    no license1★

    AI video agency skill for Claude Code, built on the Freepik/Magnific MCP tools. Adapted from Arnie936/ai-video-agency.

  • Readme

    myl7/readme-skill/readme Skill

    1★ repo

    Let agents write structured readmes

  • Create visual readme

    MattModeCode/claude-skills/skills/create-visual-readme Skill

    1★ repo

    A growing library of my published Claude Code skills — drop one into ~/.claude/skills/ and go.

  • Compact readme

    TitusKirch/skills/skills/docs/compact-readme Skill

    1★ repo

    Agent skills by Titus Kirch — installable via skills.sh in Claude Code, Codex, Cursor, OpenCode and friends.

  • Changelog

    geekswamp/agent-skills/skills/changelog Skill

    no license1★ repo

    A curated set of reusable Codex skills for common engineering tasks.

  • Sample skill

    LingYi-Liang/Skillsense/examples/sample_skill Skill

    1★ repo

    Local-first dashboard that shows whether AI coding agents actually loaded, read, or invoked the right skills.

  • Changelog

    pavelsimo/skills/skills/changelog Skill

    no license1★ repo

    A collection of agent skills for AI-assisted development.

  • Changelog summary

    skills-lock/example-claude-code-skills/.claude/skills/changelog-summary Skill

    1★ repo

    Worked example for skil-lock — pin AI Skill behavior; block unapproved drift in CI.

  • Github contribution intel

    GregoryKogan/opensource-skills/skills/github-contribution-intel Skill

    1★ repo

    Cursor agent skills for open-source triage: fetch contribution docs from a public GitHub repo, and export open issues (including “good first issue”) to JSONL for offline or LLM review. Skills live under skills/; .cursor/skills symlinks there.

  • Readme writing

    zhoux77899/flawless/skills/readme-writing Skill

    1★ repo

    Cross-agent plugin skills for better README, repository, and code quality across Claude Code and Codex.

  • Changelog generator

    zgroves24/agent-operator-skills/skills/changelog-generator Skill

    1★ repo

    Reusable AI-agent skills for planning, verification, security reviews, SEO audits, changelogs, CLIs, and multi-step coding loops.

  • Clean skill

    tolztoy/skillci/fixtures/clean-skill Skill

    1★ repo

    CI for AI agent skills — lint, safety-audit, and scenario-test SKILL.md skills before you trust them. No Docker required.

  • Curating readme

    liang-senbei/curating-readme Skill

    no license1★

    Claude Agent Skill: audit a repository's real info and update its README + related docs into a standardized structure — grounded in the repo, never fabricated.

  • Readme skill

    loveranmar/readme-skill/skills/readme-skill Skill

    1★ repo

    Claude Code skill that writes beautiful, professional READMEs that look hand-crafted, not generated. npx skills add evol1228/readme-skill

  • Readme

    thuanvd378/write-me-a-readme/plugins/write-a-readme/skills/readme Skill

    1★ repo

    An agent skill that turns project evidence into polished READMEs: selectable voices, editable SVG banners, social previews, and validation.

  • Changelog generator

    sxntixgo/claude-code-skills-for-security/demo/skills/changelog-generator Skill

    no license0★ repo

    Source for "Claude Skills for Security" — a 45-minute community-conference talk at DC435 on 2026-06-05. Ships a LaTeX writeup and a Beamer deck built from a shared style package.

  • Awesome readme

    fralapo/awesome-agent-skills/skills/awesome-readme Skill

    0★ repo

    Production-grade agent skills for Claude Code and any SKILL.md-compatible AI agent. Each skill is mined from real corpora, official docs, and books. Install as a plugin or drop into any agent.

  • Doc sweep

    F2077/doc-sweep/plugins/doc-sweep/skills/doc-sweep Skill

    0★ repo

    Audit whether docs still match the code — and fix the drift. Claude Code plugin (/doc-sweep:sweep).

  • Changelog

    myl7/changelog-skill/changelog Skill

    0★ repo

    Let agents write changelogs following Keep a Changelog

  • Changelog

    rokurokulab/dotai/claude/plugins/dotai-base/skills/changelog Skill

    0★ repo

    Cross-tool AI coding agent config registry & installer (Claude Code + Codex). Skills, hooks, agents, marketplaces, all in one place.

  • Template

    marzun9620/agent_skills/_template Skill

    no license0★ repo

    My personal Claude Code skills — 59 of them. Use any, fork the repo, or contribute yours. Install with /plugin marketplace add marzun9620/agent_skills

  • Changelog generator

    SkillMedev/engineering-workflow/skills/changelog-generator Skill

    0★ repo

    The git, review, and release workflow every senior engineer already uses.

  • Changelog release

    kwangsing3/claude-skills-toolkit/plugins/git-tools/skills/changelog-release Skill

    no license0★ repo

    Personal Claude Code plugin marketplace — portable git workflow skills (conventional commits, docs/metadata sync, changelog releases).

  • Demo gif

    oaklake-studio/oaklake-tools/plugins/demo-gif/skills/demo-gif Skill

    0★ repo

    Oaklake Studio's Claude Code marketplace

  • Commit craft

    moses607/skillforge/skills/commit-craft Skill

    0★ repo

    SkillForge — production-ready Claude & Claude Code skills for developers, knowledge workers, and marketers. 9 free skills (MIT) + a Pro pack.

  • Changelog

    processcube-io/ProcessCube.Agent.Skills/skills/changelog Skill

    no license0★ repo

    Agent Skills (Open Standard) zur Automatisierung von Entwickler-Workflows für ProcessCube®: Dokumentation (repo-doku), Releases (release-process) und Changelogs (changelog) — für Claude Code, Codex und OpenClaw.

  • Changelog to hype

    daewoochen/oss-flywheel-skills/skills/changelog-to-hype Skill

    0★ repo

    Practical Codex-compatible skills for README, demos, launches, and OSS growth loops

  • Changelog maintenance

    mkgp-dev/codex-skills/skills/.experimental/changelog-maintenance Skill

    0★ repo

    A collection of reusable Codex skills for coding tasks.

  • Changelog

    eunai/skills/.agents/skills/changelog Skill

    0★ repo

    Agent skill packs under .agents/skills for README and changelog maintenance, Semantic Versioning, and private/public publish-boundary hygiene. MIT.

  • Code comments

    volodymyrkoval/tdd-claude/skills/code-comments Skill

    no license0★ repo

    Personal Claude Code setup for TDD

  • Readme design system

    NicolasHoyosDevss/Awesome-disruptive-readmes/skills/readme-design-system Skill

    no license0★ repo

    Reusable Codex skills for creating visual, portfolio-grade GitHub READMEs with a consistent AI Engineering identity.

  • Changelog

    ravistakumar/cast/examples/changelog Skill

    0★ repo

    Compile one Agent Skill into harness-native skills for every coding agent

All 924 in the catalog