claude-skills-cli

claude-skills-cli is a command-line tool designed for Claude Code to programmatically generate Claude Agent Skills with built-in progressive disclosure validation. It enforces a three-level skill architecture that optimizes token usage by loading metadata, documentation, and references on-demand rather than all at once. The CLI provides initialization, validation, and packaging commands with configurable strictness modes, helping teams standardize skill structure and prevent oversized documentation. It includes activation hooks that improve skill reliability in Claude Code, addressing the common issue of skills failing to auto-activate without explicit instructions.

[{"step":"Install the claude-skills-cli package globally using your preferred package manager. For npm users: 'npm install -g claude-skills-cli'. For pip users: 'pip install claude-skills-cli'.","tip":"Ensure you have Node.js (v18+) or Python (v3.10+) installed before installation."},{"step":"Initialize a new skill project by running 'claude-skills-cli init [SKILL_NAME]'. Replace [SKILL_NAME] with your skill's identifier (e.g., 'customer-onboarding').","tip":"Use kebab-case for skill names to ensure compatibility with all systems. Example: 'data-pipeline-monitor' instead of 'DataPipelineMonitor'."},{"step":"Edit the generated skill.json file to define your input fields, validation rules, and progressive disclosure steps. Use the provided templates in the ./skills/[SKILL_NAME] directory.","tip":"Start with the prompt_template.md file to define the user-facing prompt structure. Keep progressive steps simple (3-5 steps max) for better user experience."},{"step":"Run validation tests locally using 'claude-skills-cli test ./skills/[SKILL_NAME]'. Fix any validation errors before proceeding.","tip":"Use the --verbose flag to get detailed error messages: 'claude-skills-cli test ./skills/[SKILL_NAME] --verbose'."},{"step":"Publish your skill to your Claude Code environment using 'claude-skills-cli publish ./skills/[SKILL_NAME]'. The CLI will handle package bundling and dependency resolution.","tip":"For CI/CD pipelines, use the --no-install flag to skip dependency installation: 'claude-skills-cli publish ./skills/[SKILL_NAME] --no-install'."}]