Skip to content

claude-code-skills.md

Latest commit

 

History

History
189 lines (136 loc) · 5.91 KB

claude-code-skills.md

File metadata and controls

189 lines (136 loc) · 5.91 KB

Claude Code Skills Integration

Terraphim provides a set of Claude Code skills that teach AI coding agents how to use Terraphim's knowledge graph capabilities. These skills are available as a Claude Code plugin.

Installation

From GitHub

# Add the Terraphim marketplace
claude plugin marketplace add terraphim/terraphim-claude-skills

# Install the engineering skills plugin
claude plugin install terraphim-engineering-skills@terraphim-ai

From Local Clone

# Clone the repository
git clone https://github.com/terraphim/terraphim-claude-skills.git

# Add as local marketplace
claude plugin marketplace add ./terraphim-claude-skills

# Install the plugin
claude plugin install terraphim-engineering-skills@terraphim-ai

Terraphim-Specific Skills

terraphim-hooks

Knowledge graph-based text replacement using Terraphim hooks. This skill teaches Claude Code how to:

  • PreToolUse Hooks: Intercept commands before execution (e.g., replace npm install with bun install)
  • Git Hooks: Transform commit messages (e.g., replace "Claude Code" attribution with "Terraphim AI")
  • CLI Replace Command: Use terraphim-agent replace for text transformation

Example Usage:

# Replace npm with bun using knowledge graph
echo "npm install react" | terraphim-agent replace
# Output: bun install react

# JSON output for programmatic use
echo "npm install" | terraphim-agent replace --json
# Output: {"result":"bun install","original":"npm install","replacements":1,"changed":true}

Hook Configuration:

Add to .claude/settings.local.json:

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Bash",
      "hooks": [{
        "type": "command",
        "command": ".claude/hooks/npm_to_bun_guard.sh"
      }]
    }]
  }
}

session-search

Search and analyze AI coding assistant session history. This skill teaches Claude Code how to:

  • Search Sessions: Find past work by query, concept, or related sessions
  • Import History: Load sessions from Claude Code, Cursor, Aider, and other assistants
  • Analyze Patterns: Discover agent usage patterns and productivity trends
  • Export Sessions: Save sessions to JSON or Markdown

REPL Commands:

Command Description
/sessions sources Detect available session sources
/sessions import Import sessions from all sources
/sessions search <query> Full-text search
/sessions concepts <term> Knowledge graph concept search
/sessions related <id> Find related sessions
/sessions timeline Timeline visualization
/sessions export Export to file

Example Workflow:

# Launch REPL with session support
./target/release/terraphim-agent

# In REPL:
/sessions sources          # Detect available sources
/sessions import           # Import from Claude Code
/sessions search "rust"    # Find sessions about Rust
/sessions concepts "error handling"  # Concept-based search

Engineering Skills

The plugin also includes general engineering skills:

Skill Description
architecture System design, ADRs, API planning
implementation Production code with tests
testing Unit, integration, property-based tests
debugging Systematic root cause analysis
rust-development Idiomatic Rust patterns
rust-performance Profiling, SIMD, optimization
code-review Thorough review for bugs/security
documentation API docs, README, guides
devops CI/CD, Docker, deployment

Disciplined Development Workflow

For complex features, use the three-phase approach:

Phase 1: Research          Phase 2: Design           Phase 3: Implementation
┌─────────────────┐       ┌─────────────────┐       ┌─────────────────┐
│disciplined-     │  →    │disciplined-     │   →   │disciplined-     │
│research         │       │design           │       │implementation   │
│                 │       │                 │       │                 │
│ • Problem scope │       │ • File changes  │       │ • Test first    │
│ • System mapping│       │ • API signatures│       │ • Small commits │
│ • Constraints   │       │ • Test strategy │       │ • Quality checks│
└─────────────────┘       └─────────────────┘       └─────────────────┘

Knowledge Graph Integration

Skills leverage Terraphim's knowledge graph for:

Text Replacement

Define replacement patterns in docs/src/kg/:

# bun

Modern JavaScript runtime and package manager.

synonyms:: npm, yarn, pnpm, npx

Concept Search

Sessions are enriched with knowledge graph concepts for semantic search:

use terraphim_sessions::{SessionEnricher, EnrichmentConfig};

let enricher = SessionEnricher::new(config)?;
let enriched = enricher.enrich(&session)?;

// Find sessions by concept
let results = search_by_concept(&sessions, "error handling")?;

Quick Setup

Install all Terraphim hooks and skills:

# In terraphim-ai repository
./scripts/install-terraphim-hooks.sh --easy-mode

# Test hooks are working
./scripts/test-terraphim-hooks.sh

# Build with session support
cargo build -p terraphim_agent --features repl-full --release

Repository

Related Documentation