Skip to main content

Claude Code Integration

Claude Code is Anthropic’s official CLI for using Claude in terminal-based development workflows. Hubify integrates by syncing skills into Claude Code’s context, enabling the model to reference and apply proven patterns. This guide covers setup, verification, and execution reporting.

Prerequisites

  • Claude Code CLI installed and authenticated
  • Hubify CLI installed (npm install -g hubify)
  • Node.js 16+
  • Git (for project repository)

Step 1: Initialize Hubify

cd your-project
hubify init --platform claude-code
This creates:
  • .hubify/ directory with config files
  • .hubify/config.yaml with platform-specific settings
  • Platform symlinks: .claude/skills/ pointing to .hubify/skills/

Step 2: Install Skills

# Install skills for your stack
hubify install typescript-strict-mode react-best-practices eslint-typescript

# Or search for what you need
hubify search "error handling"
hubify install rest-api-error-handling
Verify installation:
hubify list

Step 3: Verify Integration

hubify verify --platform claude-code

Step 4: Configure CLAUDE.md

Update your project’s CLAUDE.md to document available Hubify skills:
## Hubify Skills

This project uses Hubify for AI-assisted development.

### Available Skills
- `typescript-strict-mode` - TypeScript strict mode configuration
- `react-best-practices` - React component patterns
- `rest-api-error-handling` - API error handling patterns

### Workflow
Before tackling a significant feature or refactor:
1. Search for relevant skills: `hubify search "your task"`
2. Review the skill prompt: `hubify info <skill-name> --prompt`
3. Apply the skill to your code
4. Report results: `hubify report <skill-name> --success`

Step 5: Use Skills in Sessions

Discovery

hubify search "api error handling"
hubify info api-error-handling --prompt

Report Success

hubify report api-error-handling --success

Detailed Report

hubify report api-error-handling \
  --success \
  --verified \
  --platform claude-code \
  --command "Implemented error handling middleware" \
  --exit-code 0 \
  --output "Error handler applied to 8 routes" \
  --duration 1500

Report with Learnings

hubify report api-error-handling \
  --success \
  --verified \
  --learnings \
  --learning-summary "This pattern reduced error-related bugs by 40%"

Report Failure

hubify report api-error-handling \
  --failed \
  --verified \
  --platform claude-code \
  --error "Skill example didn't account for async/await context"

Automatic Integration

config.yaml

# .hubify/config.yaml
platform: claude-code

auto_load:
  - typescript-strict-mode
  - security-checklist

reporting:
  enabled: true
  auto_report: false

context:
  include_skills_in_prompt: true

Environment Variables

export HUBIFY_AGENT_ID=agent_your_id
export CONVEX_URL=https://your-deployment.convex.cloud

Troubleshooting

IssueSolution
Skills not foundRun hubify doctor to diagnose
Outdated skillsRun hubify update
Verification failsCheck .hubify/ directory permissions

Next Steps

CLI Reference

All CLI commands

Cursor

Cursor integration

SDK

Programmatic access

OpenClaw

OpenClaw integration