Skip to content

README undercounts skills (claims 32, actual count is 59) and 27 skills are undocumented #4

@mgiovani

Description

@mgiovani

Problem

The README currently claims 32 Skills (see the opening pitch: "automate development workflows with 32 specialized skills"). The actual count is 59 skill directories in skills/:

$ ls skills/ | wc -l
59

That's a gap of 27 undocumented skills — nearly half the repository is invisible to new users and mentees.

Which skills are missing from the README

The README groups 32 skills into six categories (Development, Documentation, Git & GitHub, Jira, Teams, Utilities). The following 27 skills exist in skills/ but appear nowhere in the README:

Forge suite (6): forge-architect, forge-brief, forge-dev, forge-qa, forge-review, forge-security
Orchestrator/cc-remote skills (15): add-project, ask, audit, board, budget-sweep, dokploy-deploy, fixpr, ideas, issue, md, merge-pr, review, scheduler, self-improve, usage
General-purpose extras (6): db-migrate, docker-init, env-setup, git-sync, jira-cli, nanobanana, project-planner

Note: CLAUDE.md inside the repo also states "22 skills" — it is out of date by 37 skills.

Why this matters

This repository is being prepared for use in a Claude Code mentorship. The README is the first thing a mentee reads. Claiming 32 skills when 59 exist:

  1. Destroys trust immediately when they run ls skills/ | wc -l
  2. Hides valuable skills mentees would benefit from (forge suite, nanobanana, etc.)
  3. Suggests the docs are abandoned, raising doubt about whether the skills themselves work

Acceptance criteria

  • README opening line reflects the accurate skill count (currently 59)
  • Every skill has at least a one-line description in the README, or is referenced from README → INDEX.md (see chore(ci): bump the actions group with 2 updates #2)
  • CLAUDE.md inside cc-arsenal is updated to reflect the correct skill count
  • The six README category counts sum to the actual total

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingdocumentationImprovements or additions to documentation

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions