Skip to content

ramonclaudio/skills

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

238 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Skills

A collection of the plugins, skills, agents, commands, hooks, and workflows I use in Claude Code, open sourced for everyone. 9 plugins, grab what you need.

Context kept vanishing between sessions. Commits took too many steps. No good way to audit a codebase or coordinate parallel agents. So I built the tools I wanted and started publishing them here. Ping me if they save you time: @ramonclaudio.

Install

Note

Requires Claude Code v1.0.33+.

Prerequisites

Different plugins have different dependencies. Install only what you need.

Git (required by most plugins)
# macOS
brew install git
# or: xcode-select --install

# Linux (Debian/Ubuntu)
sudo apt-get install git

# Linux (Fedora)
sudo dnf install git

# Windows
winget install --id Git.Git -e --source winget
GitHub CLI (required by commit)
# macOS
brew install gh

# Windows
winget install --id GitHub.cli

Linux — see the official install guide.

After installing, authenticate with gh auth login.

QMD (required by qmd)
npm install -g @tobilu/qmd
# or
bun install -g @tobilu/qmd

Requires Node.js >= 22 or Bun >= 1.0.0. On macOS also install Homebrew SQLite: brew install sqlite.

FFmpeg (required by gif and frames)
# macOS
brew install ffmpeg

# Linux (Debian/Ubuntu)
sudo apt-get install ffmpeg

# Linux (Fedora)
sudo dnf install ffmpeg

# Windows
winget install --id Gyan.FFmpeg
Agent Teams env var (required by teams)

The teams plugin needs the experimental agent teams feature flag. Add it to your settings.

Global (all projects) — ~/.claude/settings.json:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Project-only — .claude/settings.local.json in your repo root:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Or export it in your shell before launching Claude Code:

export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

Add the marketplace:

/plugin marketplace add ramonclaudio/skills

Then install any plugin:

/plugin install handoff@skills

The skill shows up as a /command you can run immediately.

Plugins

Each plugin is a self-contained directory with a manifest, one or more skills, and optionally hooks, MCP servers, or reference docs.

Plugin What it ships Requires Version
handoff 2 skills, 2 hooks git 1.6.0
qmd 2 skills, 17 commands, 1 MCP server qmd, git 1.8.0
commit 1 skill, 1 hook, 2 scripts git, gh 1.5.0
polish 1 skill git 1.5.0
audit 1 skill, 1 script git 1.5.0
techdebt 1 skill, 1 script git 1.5.0
gif 1 skill ffmpeg 1.5.0
frames 1 skill ffmpeg 1.5.0
teams 1 skill CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS env var 1.4.0

What's in each plugin

handoff

Session continuity. Preserves context across sessions, machines, and compactions.

Skills:

  • /handoff:end - archive session state with health checks (build/test/lint), severity, done/failed/blockers
  • /handoff:start - auto-triggered on critical context loss. Deep rehydration with drift detection.

Hooks (2):

  • SessionStart - injects resume context on startup/resume
  • PostCompact - re-injects context after compaction

Hooks run automatically. The only command you run is /handoff:end when you're done for the day.

qmd

Reference collection manager. Clone GitHub repos OR register local directories, index them, search with hybrid BM25/vector/reranking. All on-device. Wraps qmd CLI 2.1.0+ as a Claude Code skill — Claude searches via the MCP server, you run slash commands for indexing and maintenance.

Skills:

  • /qmd:add <url|owner/repo|local-path> - clone (GitHub) or register (local), auto-detect file types, write ignore: globs, embed with AST chunking, verify
  • qmd:search - non-invocable guide teaching Claude when and how to compose mcp__qmd__query calls with typed sub-queries (lex/vec/hyde) and intent for disambiguation

Commands (17): /qmd:status, /qmd:update, /qmd:embed, /qmd:cleanup, /qmd:bench, /qmd:pull, /qmd:mcp, /qmd:remove, /qmd:rename, /qmd:collection-show, /qmd:collection-update-cmd, /qmd:collection-include, /qmd:collection-exclude, /qmd:context, /qmd:search, /qmd:query, /qmd:get

MCP server: Exposes query (hybrid pipeline with typed sub-queries + intent + reranking), get, multi_get, status — wired automatically via the plugin's .mcp.json.

commit

Atomic commits with conventional format, grouped by architectural layer. GPG signs when available.

Skill: /commit [--analyze] [--push] [--pr] [--merge PR#]

5-phase workflow: analysis, execution, verification, push/PR creation, merge. Ships a PreToolUse hook that blocks force-push, --no-verify, and GPG bypass. Helper scripts validate commit message format and block dangerous git operations.

polish

Full codebase sweep that scores every file 0-10 on polish potential and refines files scoring 5+. Unlike the built-in /simplify (which targets recently changed files), /polish analyzes the entire codebase.

Skill: /polish [--dry-run] [path]

5-phase: discovery (glob all source), deep analysis (0-10 scoring), queue creation, parallel refinement (up to 5 agents), verification. Uses opus model.

audit

Codebase audit with 4 parallel agents. Finds bugs, architectural rot, and dead weight.

Skill: /audit [--dry-run] [--recent] [path]

4 agents run in parallel: Architecture/Design, Bugs/Logic, Security/Dependencies/Performance, Convention Compliance. Uses opus model.

techdebt

End-of-session tech debt sweep.

Skill: /techdebt [--dry-run] [path]

3 parallel agents scan for: duplicated code (>10 lines), dead exports, unused deps, stale TODOs, bloated files (>300 lines), naming inconsistencies.

gif

Convert screen recordings to compressed GIFs with ffmpeg two-pass palette.

Skill: /gif <video-path> [--width N] [--fps N] [--speed N] [--crop] [--full]

Handles HDR-to-SDR conversion. Defaults: 10fps, 640px width, bayer dither.

frames

Extract video frames as images so Claude can analyze screen recordings, bug repros, and demos.

Skill: /frames <video-path>

Smart sampling: 3-15 frames based on video length.

teams

Orchestrate teams of Claude Code sessions working in parallel.

Skill: /teams <task> [--dry-run] [--plan-approval] [--delegate] [--roles N]

6-phase: recon, decomposition, team design, task graph, spawn & brief, coordination. File ownership prevents conflicts. Uses opus model.

Important

Requires the CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS environment variable.

Plugin structure

Every plugin follows this layout:

plugins/{name}/
  .claude-plugin/plugin.json         manifest (name, version, description)
  skills/{skill-name}/SKILL.md       skill instructions + frontmatter hooks
  skills/{skill-name}/scripts/*.sh   helper scripts (deterministic ops)
  skills/{skill-name}/references/    checklists, patterns, agent prompts
  hooks/hooks.json                   plugin-level event hooks (handoff)
  hooks/scripts/*.sh                 hook handler scripts (handoff)
  commands/*.md                      extra commands (qmd only)
  .mcp.json                          MCP server config (qmd only)
  README.md                          plugin docs

Version pinning

The marketplace tracks main. Pin to a specific version:

/plugin marketplace add ramonclaudio/skills#v1.1.0

Updating

/plugin marketplace update skills

Or update a single plugin:

/plugin update handoff@skills

Uninstall

/plugin uninstall handoff@skills

Remove the marketplace entirely:

/plugin marketplace remove skills

Contributing

Ping me if there are any bugs or feature requests - open an issue or PR directly.

License

MIT

About

Custom Claude Code skills, installable individually as plugins.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages