agent-skills

Private Claude Code skills repo.

Setup on a new machine

git clone <this-repo> ~/Source/agent-skills
cd ~/Source/agent-skills
./setup-symlinks.sh

Verify the setup at any time with:

./setup-symlinks.sh --check

Security

Skills are markdown injected as instructions to Claude during inference. A malicious skill can instruct Claude to run shell commands, access files, etc. Always read SKILL.md before installing skills from unknown repos.

There is no per-skill token breakdown during inference. Use /cost for total session usage.

Structure

Local skills (this repo)

Defined in skills/, symlinked to ~/.claude/skills/ by setup-symlinks.sh.

skills/
└── dev/
    ├── commit
    ├── explain-code
    ├── java-build-check
    ├── java-test-run
    └── refresh-docs

External skills — type A: .claude/skills/ convention

Repos with this structure can be added directly to additionalDirectories in settings.json — Claude Code discovers their skills automatically without any symlinks.

Currently none are referenced this way. decebals/claude-code-java has this structure but is managed via the hub (see type B) to keep all external skills in one place.

External skills — type B: skills/ convention

Repos with this structure cannot be used with additionalDirectories directly. setup-symlinks.sh selectively symlinks the desired skills into ~/Source/agent-skills-external/.claude/skills/, which is the hub directory referenced by additionalDirectories in settings.json.

~/Source/agent-skills-external/    ← machine-specific, not in repo
└── .claude/skills/

    [general]
    ├── planning-with-files        ← othmanadi/planning-with-files
    ├── skill-creator              ← anthropics/skills
    ├── docx                       ← anthropics/skills
    ├── pdf                        ← anthropics/skills
    ├── xlsx                       ← anthropics/skills
    └── pptx                       ← anthropics/skills

    [dev]
    ├── claude-api                 ← anthropics/skills
    ├── mcp-builder                ← anthropics/skills
    ├── webapp-testing             ← anthropics/skills
    ├── slack-gif-creator          ← anthropics/skills
    │
    └── [java]
        ├── api-contract-review    ┐
        ├── architecture-review    │
        ├── changelog-generator    │
        ├── clean-code             │
        ├── concurrency-review     │
        ├── design-patterns        │
        ├── git-commit             │
        ├── issue-triage           │ decebals/claude-code-java
        ├── java-code-review       │
        ├── java-migration         │
        ├── jpa-patterns           │
        ├── logging-patterns       │
        ├── maven-dependency-audit │
        ├── performance-smell-detection
        ├── security-audit         │
        ├── solid-principles       │
        ├── spring-boot-patterns   │
        └── test-quality           ┘

Plugins

Plugins are local installations — they are not stored on the Anthropic account and must be installed manually on each machine, directly in Claude Code (not in the terminal):

/plugin install ralph-loop@claude-plugins-official
/plugin marketplace add obra/superpowers
/plugin install superpowers@superpowers-dev