wzkariampuzha-claude-skills

Claude Skills Collection

Custom Claude skills for my specialized workflows.

Skills

frontend-styleguide

Location: skills/frontend-styleguide/SKILL.md Purpose: Create comprehensive frontend style guides efficiently without wasting context on repeated exploration. Use when:

• Creating new style guides for web projects
• Editing existing style guides
• Adding components to component libraries
• Documenting design systems Key features:
• Explores codebase once with subagent, documents to CLAUDE.md, never re-explores
• Distinguishes between creating new vs editing existing style guides
• Integrates with frontend-design skill for professional quality
• Asks about design system preferences (shadcn/ui, Material UI, Bootstrap, Tailwind)
• Asks about font preferences (Google Fonts vs system fonts)
• Creates reusable component functions, not just documentation
• Includes comprehensive standard component checklist Core principle: Explore once. Document permanently. Create professionally.

test-execution-manager

Location: skills/test-execution-manager/SKILL.md Purpose: Manage test execution via test-runner subagents with incremental timeout escalation strategy. Use when:

• Running tests via test-runner subagents
• Test suites have variable execution times
• Need to show progress quickly while handling slow tests
• Working within timeout constraints Key features:
• Incremental timeout escalation (10s→20s→30s→45s→60s→90s→120s→180s→300s→600s max)
• Delegates to test-runner subagents (never reads terminal output directly)
• Test inclusion verification after each pass
• User confirmation before expanding test scope
• Creates fix plans when tests fail (not just listing failures)
• Hard limit enforcement at 600s (10 minutes) Core principle: Start fast. Escalate incrementally. Never exceed limits.

Hooks

ruff-python

Location: hooks/PostToolUse.ruff-python

Purpose: Automatically run ruff linter and formatter on Python files after editing.

Use when:

• You want automatic Python code formatting
• You want to catch linting issues immediately
• You want to maintain consistent Python code style

Key features:

• Runs ruff check && ruff format on edited Python files
• Triggers after Edit or Write tool operations
• Shows output to agent so they can fix issues
• Never blocks edits (always exits success)
• Validates file extension and tool type
• Helpful error messages if ruff not installed

Core principle: Automatic, transparent, never blocking.

Installation:

After installing the plugin via marketplace:

cd ~/.claude/plugins/marketplaces/wzkariampuzha-claude-skills/hooks

Then run the installer:

sh install-ruff-hook.sh

Or from cloned repository:

cd claude-skills/hooks

sh install-ruff-hook.sh

See hooks/README.md for detailed installation and configuration instructions.

Requirements:

• jq (JSON parser)
• ruff (Python linter/formatter)

Installation

Method 1: Plugin Marketplace (Recommended)

Add the marketplace to Claude Code:

/plugin marketplace add wzkariampuzha/claude-skills

Install skills:

/plugin install frontend-styleguide@wzkariampuzha-claude-skills

/plugin install test-execution-manager@wzkariampuzha-claude-skills

Install hooks (optional):

cd ~/.claude/plugins/marketplaces/wzkariampuzha-claude-skills/hooks

sh install-ruff-hook.sh

Method 2: Manual Installation

Clone the repository:

git clone https://github.com/wzkariampuzha/claude-skills.git

For skills:

cp -r claude-skills/skills/frontend-styleguide ~/.claude/skills/
cp -r claude-skills/skills/test-execution-manager ~/.claude/skills/

For hooks:

cd claude-skills/hooks
./install-ruff-hook.sh

The skills and hooks will be automatically available in your Claude Code sessions.