Package Exports

genskills
genskills/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (genskills) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

GenSkills

NPM Last Update license NPM Unpacked Size npm package minimized gzipped size

43 AI-powered skills for Claude Code - code review, testing, deployment, debugging, scaffolding, performance optimization, and more. Install once, supercharge your entire development workflow.

Free and open-source. Zero configuration required.

Quick Start

npx genskills install

All 43 skills are installed into your project's .claude/skills/ directory. Use them in Claude Code as /genskills:<skill-name>.

Skills Overview

Code Quality (11 skills)

Skill	Description
`code-review`	Multi-dimensional code review - security, performance, correctness, maintainability
`refactor`	Intelligent refactoring - extract, inline, rename, restructure while preserving behavior
`security-audit`	OWASP top 10, dependency vulnerabilities, secrets detection, CSP analysis
`test-generator`	Generate comprehensive test suites - Jest, Vitest, pytest, and more
`lint-fix`	Auto-detect and fix linting issues across your codebase
`type-check`	Run type checking and fix errors in TypeScript, Python (mypy/pyright)
`dependency-audit`	Unused packages, outdated versions, duplicates, license conflicts, bundle impact
`error-boundary`	Find unhandled errors - missing catch blocks, unhandled rejections, missing boundaries
`accessibility-audit`	WCAG 2.2 compliance - alt text, ARIA, keyboard nav, color contrast, touch targets
`dead-code`	Detect and remove unused exports, functions, components, types, and variables
`codemod`	AST-based code transformations for large-scale refactoring

Workflow (9 skills)

Skill	Description
`git-commit`	Smart git commits - conventional format, AI-generated messages, smart staging
`pr-create`	Create PRs with generated titles, descriptions, and test plans
`pr-review`	Automated PR review with inline comments and approval recommendations
`deploy`	Manage deployments across platforms - Vercel, AWS, Docker, K8s
`ci-fix`	Diagnose and fix failing CI/CD pipelines - build logs, test failures, config issues
`branch-manager`	Create, switch, merge, rebase, clean up stale branches
`monorepo`	Navigate and manage monorepo tooling - Turborepo, Nx, Lerna, pnpm workspaces
`git-hooks`	Generate and manage git hooks - pre-commit, commit-msg, pre-push
`release`	Manage releases - versioning, tagging, changelogs, publishing

Development (12 skills) - with 184 reusable templates

Skill	Templates	Description
`debug`	2	Advanced debugging - git bisect, memory leaks, flame graphs, framework-specific tools (React DevTools, Node.js --inspect, Python pdb, Go delve)
`scaffold`	2	Scaffold 25+ types (components, features, APIs, workers) across 30+ frameworks with pattern detection
`perf-optimize`	17	Full-stack performance - memory profiling, concurrency, rendering, query plans, Core Web Vitals, Lighthouse CI
`migrate`	28	40+ migration types - strangler fig pattern, AST codemods (jscodeshift/ts-morph), JS-to-TS, CI/CD migration
`env-setup`	4	Cross-platform env validation - security checks, network diagnostics, performance baselines, team onboarding
`db-migrate`	29	Zero-downtime migrations - expand-contract, gh-ost, multi-database (PostgreSQL/MySQL/SQLite/MongoDB/Redis)
`i18n`	2	ICU message format, RTL audit, CLDR plural rules, pseudo-localization, XLIFF/PO export
`project-starter`	30	Architecture presets (Clean/Hexagonal/DDD/CQRS), auth starters, observability, CI/CD, deployment configs
`docker-gen`	10	Security-hardened Docker - Distroless, BuildKit caching, multi-environment, monitoring stack, K8s-ready
`api-client-gen`	29	Typed API clients - TanStack Query hooks, tRPC, GraphQL, circuit breaker, OAuth2 PKCE, WebSocket/SSE
`mock-data`	9	Domain-specific data generation, statistical distributions, streaming at scale, MSW servers, anonymization
`config-gen`	22	20+ tools - Biome, Renovate, GitHub Actions, Husky v9, security configs, monorepo, config-as-code

Documentation (5 skills)

Skill	Description
`doc-gen`	Generate inline docs - JSDoc, docstrings, module documentation
`api-docs`	Generate OpenAPI/Swagger specs, endpoint references, request/response examples
`readme-gen`	Generate or update comprehensive README.md for any project
`architecture-diagram`	Generate Mermaid/PlantUML diagrams from codebase analysis
`storybook`	Generate Storybook stories with variants, controls, and docs

Project Management (3 skills)

Skill	Description
`task-tracker`	Track and manage project tasks, TODO lists, and work items
`changelog-gen`	Generate CHANGELOG.md from git history in Keep a Changelog format
`release-notes`	Generate polished release notes for GitHub Releases

DevOps (3 skills)

Skill	Description
`infra-gen`	Generate IaC templates - Terraform, Pulumi, CloudFormation for AWS/GCP/Azure
`k8s-gen`	Generate K8s manifests - deployments, services, ingress, Helm charts, Kustomize
`github-actions`	Generate and fix GitHub Actions workflows - CI/CD, matrix builds, deployments

Templates Architecture

Development skills ship with 184 reusable template files stored in each skill's templates/ folder:

skills/development/<skill-name>/
  SKILL.md              # Skill logic and instructions
  templates/            # Extracted code templates
    base-client.ts      # Example: API client base class
    docker-compose.yml  # Example: Docker Compose config
    ci-pipeline.yml     # Example: CI/CD workflow
    ...

Templates are independently maintainable - update a template without modifying skill logic. Each SKILL.md references templates via **Template:** templates/filename.ext.

CLI

npx genskills <command>

Command	Description
`install`	Install or reinstall all enabled skills
`install <skill>`	Install a specific skill
`install --force`	Force reinstall even if unchanged
`list`	List all available skills and their status
`list --installed`	Show only installed skills
`enable <name>`	Enable a skill or category
`disable <name>`	Disable and remove a skill or category
`init`	Create a `genskills.config.json` interactively
`init -y`	Create config with all defaults
`update`	Check for and apply skill updates
`update --check`	Dry run - show what would change
`doctor`	Diagnose installation issues
`clean`	Remove orphaned skills
`clean --backups`	Also remove backup directory

Configuration

Customize which skills are installed by creating a genskills.config.json:

npx genskills init

Or create it manually:

{
  "$schema": "./node_modules/genskills/schemas/genskills-config.schema.json",
  "version": "1.0",
  "categories": {
    "code-quality": true,
    "workflow": true,
    "project-management": true,
    "documentation": false,
    "development": true,
    "devops": true
  },
  "skills": {
    "deploy": {
      "enabled": false
    },
    "code-review": {
      "enabled": true,
      "settings": {
        "defaultMode": "deep",
        "languages": ["typescript", "python"]
      }
    }
  },
  "hooks": {
    "autoRegister": true
  }
}

Config Resolution

Individual skill enabled overrides its category setting
Category false + skill enabled: true = skill gets installed
Category true + skill enabled: false = skill is skipped
No config file = all 43 skills installed

How It Works

Run npx genskills install
Installer detects your project root
Reads genskills.config.json (if it exists)
Copies enabled skills into .claude/skills/genskills--<name>/
Writes .genskills-manifest.json to track versions and checksums
Backs up previously installed skills before overwriting

All installed skills are prefixed with genskills-- to avoid conflicts with your own custom skills.

Troubleshooting

# Check for issues
npx genskills doctor

# Force reinstall all skills
npx genskills install --force

# Remove orphaned skills
npx genskills clean

Requirements

Node.js >= 18.0.0
Claude Code / Claude CLI

License

MIT

genskills