claude-skills
Learn project conventions from your conversation history, Git commits, and code. Generate reusable skills that encode your team's decisions—with evidence links.
Installation
Via Plugin (Recommended)
# Add marketplace
/plugin marketplace add usedhonda/claude-skills
# Install
/plugin install skill-from-history@usedhonda-claude-skills
Manual Installation
# Global (all projects)
mkdir -p ~/.claude/skills/skill-from-history
cp -r skills/skill-from-history/* ~/.claude/skills/skill-from-history/
# Project-specific
mkdir -p .claude/skills/skill-from-history
cp -r skills/skill-from-history/* .claude/skills/skill-from-history/
Principles
| Principle | Description |
|---|
| Project Learning | Learn from YOUR history, not generic best practices |
| Negative Learning | Learn what NOT to do from corrections |
| Evidence-first | Every pattern links to its source [E1][E2] |
| Context Engineering | Optimize for attention, not just tokens |
| Rules have half-life | Learning includes forgetting |
How It Learns
Conversations + Commits + Code
↓
Pattern Extraction
↓
Evidence Linking
↓
Human Review Gate
↓
Skill Generation
↓
Decay & Archival
Use Cases
"I keep making the same correction"
"No, don't use Express. We use Hono now."
Your correction becomes a constraint. Next time, the AI already knows.
"New members don't know our conventions"
Tribal knowledge evaporates. claude-skills extracts it from actual behavior—with receipts.
"The AI forgot what we discussed"
Long contexts lose focus in the middle. We anchor critical decisions at the edges.
Compared to
| Tool | Approach | claude-skills |
|---|
| Cursor Rules | Declare rules (human writes) | Observe patterns (history extracts) |
| Devin Knowledge | Store knowledge | Make knowledge executable |
| Generic linters | Enforce universal rules | Enforce YOUR conventions |
Available Skills
Project-Specific Skill Generator - Analyze your conversation history, Git commits, and codebase to generate project-specific agents and skills.
What it does:
- Reads your Claude Code conversation history
- Analyzes Git commit patterns
- Extracts recurring workflows and corrections
- Generates reusable agents (roles) and skills (workflows)
Commands:
/skill-from-history:learn-status # Check current learning state
/skill-from-history:learn-init # Initialize Golden Tasks harness
/skill-from-history:learn-gen # Generate agents/skills from history
/skill-from-history:learn-check # Run evaluation against Golden Tasks
/skill-from-history:learn-promote # Promote validated constraints
Example workflow:
# 1. Check what patterns exist
/skill-from-history:learn-status
# 2. Generate skills from your history
/skill-from-history:learn-gen --skills
# 3. Output: .claude/skills/{name}/SKILL.md
Or say: "履歴からスキル作成", "analyze patterns", "learn from history"
Parallel Development Workflow - Decompose large tasks into parallel Claude Code sessions with auto-merge.
What it does:
- Decomposes an epic into isolated tasks (T01, T02, ...)
- Creates branches and worktrees for each task
- Dispatches tasks to multiple Claude Code sessions
- Auto-merges PRs based on risk policy
Commands:
/parallel-dev-orchestrator:par-status # Show active plans and PR status
/parallel-dev-orchestrator:par-init # Check GitHub prerequisites
/parallel-dev-orchestrator:par-plan # Decompose epic → plan.yaml
/parallel-dev-orchestrator:par-dispatch # Submit tasks to sessions
/parallel-dev-orchestrator:par-harvest # Merge PRs and generate report
Example workflow:
# 1. Check environment is ready
/parallel-dev-orchestrator:par-init
# 2. Plan task decomposition
/parallel-dev-orchestrator:par-plan "Add OAuth2 authentication"
# 3. Dispatch to parallel sessions
/parallel-dev-orchestrator:par-dispatch
# 4. Watch and merge PRs
/parallel-dev-orchestrator:par-harvest --watch
Risk Policy:
| Level | Auto-merge | When |
|---|
| low | ✅ | Isolated changes, CI passing |
| medium | ✅ | + Required checks + scope isolation |
| high | ❌ | Auth, payments, data deletion → manual review |
Or say: "並列開発", "parallel tasks", "task decomposition"
Requirements
- Claude Code (Pro, Max, Team, or Enterprise)
- Git repository (recommended for full analysis)
Contributing
Issues and PRs are welcome!
