Skills

Opinionated dev workflows — commits, PRs, TypeScript, CLIs, and more. Each skill is a specialized prompt template that teaches AI agents domain-specific workflows and best practices.

Installation

Claude Code Marketplace (recommended)

# Register the marketplace
/plugin marketplace add johnie/skills

# Install all skills
/plugin install skills@johnie

Alternative: skills.sh CLI

# Install all skills
npx skills add johnie/skills

# Install a specific skill
npx skills add johnie/skills --skill <skillName>

Skills

/commit - Semantic git commit automation

Create semantically correct, granular git commits by analyzing staged and unstaged changes.

Features:

• Automatic staging of all tracked changes
• Intelligent grouping of related changes into atomic commits
• Conventional commit format with semantic types
• Built-in safety checks for merge conflicts and protected branches

Commands:

• /commit - Auto-commit without confirmation
• /commit -v or /commit --verify - Show plan and ask for confirmation
• /commit --dry-run - Preview commit plan without executing
• /commit --amend - Amend last commit (requires -v verification)
• /commit push - Commit and push to remote branch
• /commit push -v - Push with verification prompt

Commit Types:

• feat - New feature
• fix - Bug fix
• refactor - Code restructuring
• chore - Maintenance, dependencies, config
• docs - Documentation only
• test - Adding/updating tests
• style - Formatting, whitespace
• perf - Performance improvement

/pr - GitHub PR management

Create, update, and review GitHub PRs with structured templates and comprehensive workflows.

Features:

• Structured PR templates with What/Why/How sections
• Smart generation from commits and diffs
• Update existing PRs while preserving user edits
• Code review analysis with quality feedback
• Draft PR support for work-in-progress changes

Commands:

• /pr create - Create PR with structured template
• /pr create -v - Preview draft before creating
• /pr create --draft - Create as draft PR (WIP)
• /pr update - Update existing PR after new commits
• /pr update -v - Preview changes before updating
• /pr review <pr> - Review PR by number or URL

Workflows:

• Create: Analyzes commits and diffs to generate comprehensive PR descriptions with proper formatting
• Update: Regenerates What/How/Changes sections while preserving Testing, Screenshots, and Deployment notes
• Review: Provides structured feedback on code quality, testing, security, and performance

Template Sections:

• What - Concise summary of changes
• Why - Context and motivation
• How - Implementation approach
• Changes - Bullet list of modifications
• Testing - Checklist for test coverage
• Deployment - Special deployment considerations
• Screenshots - Visual proof for UI changes

/gh-logs - GitHub Actions log analysis

Fetch and analyze GitHub Actions logs via gh CLI. Diagnoses CI failures, detects flaky tests, profiles slow steps, and suggests fixes. Stop clicking through the web UI — the terminal is faster, searchable, and doesn't crash on large output.

Features:

• Automatic failure diagnosis with root cause analysis
• Flaky test detection by comparing recent runs
• Step timing profiling to find bottlenecks
• Failure history and trend analysis
• Real-time workflow monitoring
• Pattern matching against 80+ known failure signatures

Commands:

• /gh-logs - Auto-detect repo + branch, diagnose latest failure
• /gh-logs <run-id> - Analyze a specific run
• /gh-logs --flaky - Detect flaky tests across recent runs
• /gh-logs --slow - Profile step timing, find bottlenecks
• /gh-logs --history [n] - Analyze last n failures (default 10)
• /gh-logs --watch - Monitor a running workflow in real time

Failure Categories:

• Test failures (Jest, Vitest, pytest, Go, Rust)
• Build errors (TypeScript, Webpack, esbuild, Docker)
• Dependency issues (npm, pip, Docker registry)
• Infrastructure (OOM, disk, runner shutdown, network)
• Lint/format violations
• Auth/permission failures
• Timeouts and stuck steps

Output:

• Structured diagnosis with category, root cause, log excerpt, and actionable fix
• Flaky test reports with pass/fail ratios and stabilization suggestions
• Step timing tables sorted by duration with optimization advice
• Failure trend analysis with recurring pattern detection

/stricli - TypeScript CLI framework expertise

Build type-safe CLI applications with Stricli, Bloomberg's TypeScript CLI framework.

Features:

• Compile-time type checking for command parameters
• Automatic help generation
• Flexible command routing for multi-command CLIs
• Support for flags, positional arguments, and custom parsers

Use Cases:

• Creating command-line tools with TypeScript
• Defining commands with typed flags and positional arguments
• Organizing multi-command CLIs with route maps
• Compile-time parameter validation

Core APIs:

• buildCommand - Create typed commands with parameters
• buildRouteMap - Organize multiple commands with routing
• buildApplication - Wrap commands into executable apps
• run - Execute the application

Parameter Types:

• Boolean flags (--verbose)
• Counter flags (-vvv)
• Enum flags (--format json|yaml|text)
• Parsed flags (String, Number, custom parsers)
• Variadic flags (multiple values)
• Positional parameters (tuple or array)

/wp-cli - WordPress CLI operations

WordPress CLI operations for database management, plugins, themes, users, content, and site configuration.

Features:

• Safe database migrations with automatic backups
• Bulk plugin and theme updates
• User management and audits
• Content operations
• Remote execution via SSH

Command Categories:

• wp db - Database operations (export, import, query, optimize)
• wp core - WordPress core management (install, update, verify)
• wp plugin / wp theme - Plugin and theme management
• wp user - User operations (create, list, delete, update)
• wp post / wp comment - Content management
• wp option - Settings and configuration
• wp cache / wp transient - Cache management
• wp cron - Scheduled tasks
• wp config - Configuration file management

Common Workflows:

• Site migration between environments
• Bulk plugin updates with rollback support
• User audits and cleanup
• Search-replace for URL changes
• Database backups and imports

Safety Features:

• Automatic backup reminders before destructive operations
• Dry-run flags for testing commands
• Explicit confirmation required for dangerous operations
• Skip flags for performance optimization

/typescript-engineer - Advanced TypeScript type design and error resolution

Designs complex generic types, refactors any to strict alternatives, creates type guards and utility types, resolves TypeScript compiler errors, and explains type-level concepts.

Intent Paths:

• Fix errors - Run tsc, diagnose root cause, apply fix, verify
• Design types - Clarify shape, pick technique, build incrementally
• Refactor for safety - Audit any usage, plan replacements, apply file-by-file
• Explain/teach - Identify concept, load relevant rule, explain with examples

Topics Covered:

• Generics, constraints, and type inference
• Conditional types and infer keyword
• Mapped types and template literal types
• Brand/opaque types and nominal typing
• as const, typeof, and satisfies
• Type narrowing, type guards, and assertion functions
• Function overloads and declaration merging
• Utility types including NoInfer<T> (TS 5.4+)
• Deep inference with const type parameters (TS 5.0+)
• Error diagnosis strategies

Rule Files: 15 reference documents covering core patterns, advanced generics, type-level programming, type safety patterns, and debugging — with a keyword routing table for fast lookup.

/extract-spark-meetings - Extract meeting summaries from Spark Mail

Extract structured meeting summaries and action items from Spark Mail shared links. Processes single URLs or batch processes unchecked links from links.md.

Features:

• Extracts meeting metadata (date, participants, duration)
• Captures summary and key discussion points
• Parses action items with owners and due dates
• Records decisions and next steps
• Outputs structured markdown with YAML frontmatter
• Automatic tagging by meeting type and topics
• Batch processing support with checkbox tracking

Commands:

• /extract-spark-meetings <url> - Process a single Spark Mail link
• /extract-spark-meetings - Batch process all unchecked links from links.md

Output:

• Files saved to spark-meetings/YYYY-MM-DD-{title}.md
• Rich frontmatter enables filtering by date, participant, or tag
• Action item checkboxes for task tracking
• Original Spark URL preserved for reference

Workflows:

• Single URL: Extracts one meeting and optionally updates links.md if URL is found
• Batch Mode: Processes all unchecked (- [ ]) URLs from links.md sequentially, marking each as checked (- [x]) after successful extraction

Development

This repository includes a CLI for managing skill symlinks during local development. When developing or testing skills, you need to symlink them to ~/.claude/skills/ where Claude Code discovers them.

# Interactive mode (default) - toggle skills with number keys
bun skills

# List all skills with their link status
bun skills list

# Link a specific skill
bun skills link <name>

# Unlink a specific skill
bun skills unlink <name>

# Show help
bun skills --help

Commands:

Command	Alias	Description
list	ls	List all skills with their symlink status
link <name>	-	Create symlink for a skill to ~/.claude/skills/
unlink <name>	-	Remove symlink for a skill
interactive	i	Interactive TUI mode (default when no args)

License

MIT

---

Created by @johnie