docs / local-skills

Local Skills

promptconduit skills generate --local analyzes your AI coding transcripts, detects repeated workflows, and writes reusable Claude Code slash commands to ~/.claude/skills/. It runs entirely on your machine and needs no platform account.

Free forever

No platform account needed. Uses your existing Claude Code subscription or Anthropic API key.

Usage

bash
# Analyze all installed tools, write skills globally
promptconduit skills generate --local

# Analyze only Claude Code transcripts
promptconduit skills generate --local --tool claude-code

# Scope skills to the current git repo
promptconduit skills generate --local --repo owner/repo

# Re-analyze previously seen transcripts
promptconduit skills generate --local --force

# Preview what would be generated (no files written)
promptconduit skills generate --local --dry-run

AI Provider Auto-Detection

The CLI selects an AI provider automatically, in priority order:

Priority	Provider	Requirement
1	Claude Code	`claude` CLI binary in PATH
2	Anthropic API	`ANTHROPIC_API_KEY` env var
3	OpenAI	`OPENAI_API_KEY` env var (uses gpt-4o-mini)

How It Works

The CLI reads transcript files from each installed AI tool, groups conversations by project, and sends them to the AI provider for pattern analysis. It requires at least 5 new conversations to detect patterns (override with --force).

Analyzed transcripts are tracked by SHA256 hash in ~/.config/promptconduit/local_skills_state.json to avoid reprocessing.

Output Example

output
Analyzing 47 local transcripts (global)...
Using Claude Code (claude CLI).

Detected 3 skills:

  /git-commit-workflow  (workflow, 94%)
    Git Commit Workflow
    Stage, commit, and push with conventional commit format.
    → Written to: /Users/you/.claude/skills/git-commit-workflow.md

  /ci-monitor  (workflow, 91%)
    CI Monitor
    Check CI status and iterate until green.
    → Written to: /Users/you/.claude/skills/ci-monitor.md

  /code-review  (review, 88%)
    Code Review
    Review changes for quality, security, and conventions.
    → Written to: /Users/you/.claude/skills/code-review.md

3 skills written. Use them with /git-commit-workflow, etc.

Transcript Sources

Tool	Transcript Location
Claude Code	`~/.claude/projects/*/.jsonl`
OpenAI Codex CLI	`~/.codex/*/.jsonl`
GitHub Copilot CLI	`~/.copilot/session-state/*/.jsonl`