Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                
Skip to content

ramonclaudio/skills

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

152 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Skills

Plugin marketplace for Claude Code. 9 plugins, install what you need.

I use Claude Code for everything. Session context would vanish between runs, commits needed too many steps, codebases had no good way to audit themselves. So I built the tools I wanted and open sourced them. If they saved you time, let me know.

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, 6 hooks git 1.2.0
qmd 2 skills, 21 commands, 1 MCP server qmd, git 1.4.0
commit 1 skill git, gh 1.3.0
simplify 1 skill git 1.2.0
audit 1 skill git 1.2.0
techdebt 1 skill git 1.2.0
gif 1 skill ffmpeg 1.2.0
frames 1 skill ffmpeg 1.2.0
teams 1 skill CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS env var 1.1.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 (6):

  • session-start.sh - auto-init on startup/resume, context injection on compact
  • compact-reinject.sh - re-inject context after compaction
  • session-clear.sh - reset counters, archive events
  • pre-compact.sh - auto-save before compaction
  • event-capture.sh - capture tool events (async)
  • prompt-reminder.sh - context degradation escalation

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

qmd

Reference repo manager. Clone GitHub repos, index them, search with BM25/vector/hybrid. All on-device.

Skills:

  • /qmd:add <url> - clone + auto-detect file types + index + embed
  • qmd:search - non-invocable guide teaching Claude how to compose effective queries with the query tool

Commands (21): /qmd:update, /qmd:remove, /qmd:rename, /qmd:list, /qmd:context, /qmd:cleanup, /qmd:status, /qmd:embed, /qmd:pull, /qmd:get, /qmd:multi-get, /qmd:search, /qmd:vsearch, /qmd:query, /qmd:mcp, /qmd:collection-add, /qmd:collection-list, /qmd:collection-show, /qmd:collection-update-cmd, /qmd:collection-include, /qmd:collection-exclude

MCP server: Exposes query (hybrid search with typed sub-queries), get, multi_get, status

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.

simplify

Analyze and simplify codebases using parallel background agents.

Skill: /simplify [--dry-run]

5-phase: discovery (glob all source), deep analysis (0-10 scoring), queue creation, parallel simplification (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
  hooks/hooks.json              event hooks (handoff only)
  hooks/scripts/*.sh            hook scripts (handoff only)
  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