Skip to main content
skill CX Codex

organize-skills — Claude Code skill: library audit

organize-skills audits a skill library, applies names based on backend dependencies, and repairs links and references affected by renames. Useful when several tool hubs share the same library.

MIT 139 installs ★ 750 updated 2026-10-21

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add OpenClaudia/openclaudia-skills --skill organize-skills -a claude-code
Open on GitHub

What organize-skills does

The skill inventories each entry, resolves its real directory, and checks what it depends on. A prefix follows the API or database a skill actually calls, not its subject. Skills with no backend calls go in a local category; a topical infix can group larger families.

For each rename, it updates the canonical directory, hub symlinks, the name: field in SKILL.md, and references in other skills or notes. A skill stored in a repository is moved with git mv; the instructions call for a separate commit per logical rename. That matters because an old reference can leave links pointing at the wrong path.

The final checks look for broken symlinks and lingering old names, then prompt you to confirm that the loader registers each skill under its new name. You can pass a prefix rule when invoking the skill. It asks you to review the classification before renaming anything.

What it helps with

  • assign prefixes based on API dependencies
  • rename entries in a shared skill library
  • rewire symlinks across tool hubs
  • find broken links and stale name references
  • check SKILL.md names against directory names

Example prompts for the agent

  • Audit my skill library and suggest prefixes based on each skill’s dependencies: /organize-skills.
  • Use acme-* for skills calling the Acme API and local-* for the rest: /organize-skills.
  • Find broken symlinks and update references affected by skill renames: /organize-skills.

How to install organize-skills

1Skills CLI (Vercel)

npx skills add OpenClaudia/openclaudia-skills --skill organize-skills -a claude-code

2Manually: put the files in place

~/.claude/skills/organize-skills/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/organize-skills/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about organize-skills

How do I install organize-skills in Claude Code?

Run npx skills add OpenClaudia/openclaudia-skills --skill organize-skills -a claude-code. The skill file is at ~/.claude/skills/organize-skills/SKILL.md.

What does organize-skills do?

It audits a skill library, groups names by backend dependency, and updates symlinks and references that a rename affects.

How does organize-skills decide on a prefix?

It checks the backend a skill calls. Product API or database access determines the product prefix; skills without backend calls go in a local category.

Source text

SKILL.md · MIT
---
name: organize-skills
description: Audit and reorganize a Claude Code / Codex skill library — enforce a naming convention (prefix each skill by which backend or product it touches), rename skills consistently, fix the symlinks and cross-references a rename breaks, and report broken symlinks and stale name references. Use when the user says "organize my skills", "rename these skills", "clean up the skill library", "enforce a skill naming convention", or "fix broken skill symlinks".
user_invocable: true
argument-hint: "[optional: the prefix rule, e.g. 'acme-* if it calls the Acme API, local-* otherwise']"
---

# Organize Skills

Reorganize a skill library so names encode what each skill actually touches, and keep symlinks and
cross-references consistent when you rename.

Many setups keep ONE canonical skill library in a shared dir and symlink it into each tool's hub
(e.g. `~/.claude/skills/`, `~/.codex/skills/`). Some skills live inside a project repo and are
symlinked into the hub. A single rename can therefore touch several symlinks plus every doc that
references the old name — that fan-out is what this skill manages.

## Step 1 — Inventory

List every skill and where it really lives. A hub entry is usually a symlink to the canonical dir:

```bash
for hub in <hub-1> <hub-2>; do
  echo "== $hub =="; ls -la "$hub"
done
```

Resolve each name to its real directory with `readlink -f`. Note which skills live in a project repo
versus the shared library — repo-resident renames must be `git mv` in that repo.

## Step 2 — Classify by backend (the naming rule)

The convention: **the prefix names the backend the skill depends on**, decided by what it actually
calls, not by its topic. Grep each skill dir for the tell-tale dependency:

```bash
grep -rlE "<api-host>/api|/api/<x>|<db-client>|<AUTH_TOKEN_NAME>" "$skill_dir"
```

- Calls a specific product's API / database → that product's prefix (e.g. `acme-*`).
- Pure-local (browser automation, offline SOP, file processing, no backend) → a generic/local prefix.
- Keep a topical infix when a family is large (e.g. `acme-seo-*` vs `acme-reddit-*`) so related skills sort together.

State the classification back to the user before renaming. A skill that *feels* product-specific but
makes zero backend calls belongs in the local bucket, and vice versa — go by the dependency.

## Step 3 — Rename (and fix everything a rename breaks)

For each rename `OLD → NEW`:

1. **Move the canonical dir.**
   - Shared-library-resident: `mv <lib>/OLD <lib>/NEW`
   - Repo-resident: `cd <repo> && git mv <skills-path>/OLD <skills-path>/NEW && git commit`
   - Misplaced in the wrong repo? Move it to the shared library rather than just renaming in place.
2. **Rewire symlinks in every hub.** Remove the stale link, create the new one pointing at the
   canonical dir. Do this for each tool hub that mirrors the library.
3. **Update the `name:` frontmatter** inside `NEW/SKILL.md` to match the directory — the loader keys
   on it, not on the folder name.
4. **Fix cross-references.** Other skills and any long-term memory/notes files may mention `OLD` by
   name or by old path:
   ```bash
   grep -rln "OLD" <lib> <memory-dirs> 2>/dev/null
   ```
   Replace the most-specific string first (full old *path* before the bare *name*) so a skill that
   also moved gets its path updated cleanly.

## Step 4 — Verify

```bash
# broken symlinks in any hub
for hub in <hub-1> <hub-2>; do
  find -L "$hub" -maxdepth 1 -type l ! -exec test -e {} \; -print
done
# no lingering old names
grep -rn "OLD" <lib> 2>/dev/null
# each renamed skill's name: matches its dir
grep -m1 "^name:" <lib>/NEW/SKILL.md
```

Confirm the loader re-registers each renamed skill under its new name. Remove any pre-existing dead
symlinks you find while sweeping — cheap to fix, confusing to leave.

## Notes
- Never drop a skill you didn't rename. Only touch what the convention requires.
- Renames are cheap and reversible; broken cross-references are the real cost — Steps 3.4 and 4 are the
  point of this skill, not the `mv`.
- Commit repo-resident renames one logical rename per commit so they bisect and revert independently.

© OpenClaudia · MIT · OpenClaudia/openclaudia-skills

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set73

The whole set →
podcast-edit podcast-edit processes raw podcast recordings into polished episodes: cuts pre-show chat, strips filler words using Whisper, shortens silences, and balances audio via FFmpeg. CX Codex +1 291installs similarweb-traffic similarweb-traffic fetches domain traffic estimates from SimilarWeb: monthly visits, acquisition channels, top countries, and search terms without an API key. CX Codex +1 227installs geo-query-finder geo-query-finder runs long-tail queries through ChatGPT with web search and reports which answers surface your brand. Useful when you need to check GEO visibility. CX Codex +1 222installs github-stars github-stars renders terminal charts showing daily and hourly star growth for any GitHub repo in your chosen timezone. Track launches, Product Hunt spikes, or DevRel momentum in real time. CX Codex +1 197installs ai-citations-report ai-citations-report is a Claude Code skill that builds GEO reports for a domain. It checks Google AI Overview and ChatGPT prompts that cite the site and identifies content gaps. CX Codex +1 136installs geo-analysis geo-analysis runs a GEO/SEO analysis for a domain through the Enception API and downloads a PDF on AI visibility, the market and competitors. Handy for client audits. CX Codex +1 135installs geo-difficulty geo-difficulty scores how hard a keyword is to rank for by checking page-level authority of real competitors, AI Overview citations, and the site's current position. CX Codex +1 134installs marketing-slides marketing-slides writes the outline for a pitch or sales deck, then, once you approve it, generates the slides in ChatSlide. CX Codex +1 132installs

Project sponsors

Companies that keep this analytics open