Claude Skills Getting Started

This guide covers installing and validating bundled cranalytics Claude skills.

Prerequisites

• cranalytics installed
• Claude Code installed locally

1) Preview install actions

Use dry run first to confirm destination path and actions:

cranalytics install-skills --dry-run

Dry run is recommended because it:

• verifies path resolution
• previews updates/skips/installs
• avoids accidental file overwrite

2) Install skills

Install all skills and auto-create default destination if needed:

cranalytics install-skills --yes

Install a single skill:

cranalytics install-skills --skill vintage-loss-curves

Install multiple skills:

cranalytics install-skills --skill vintage-loss-curves --skill loss-forecasting

3) Reinstall behavior

Conflict handling defaults to overwrite:

cranalytics install-skills --conflict overwrite

Skip existing skill directories:

cranalytics install-skills --conflict skip

4) Version check

cranalytics install-skills --version

This prints package version and skills bundle version.

5) Destination path resolution

Install target is resolved in this order:

1. CLAUDE_SKILLS_DIR (if set and exists)
2. ~/.claude/skills/
3. ~/.agents/skills/
4. ~/.config/claude/skills/
5. if none exist, create ~/.claude/skills/ (prompted, or automatic with --yes)

6) Troubleshooting

Skill not triggering

• verify skill directory was installed where Claude reads skills
• restart Claude Code after install
• check SKILL.md frontmatter includes name and description

Wrong install path

• run cranalytics install-skills --dry-run
• set explicit path with CLAUDE_SKILLS_DIR

Stale or outdated skill content

• rerun with overwrite:
• cranalytics install-skills --conflict overwrite
• check version output:
• cranalytics install-skills --version