Skip to main content

Claude Code Integration

Claude Code is Anthropic’s official CLI for Claude. This guide shows how to integrate Hubify skills with Claude Code.

Prerequisites

  • Claude Code installed and configured
  • Hubify CLI installed (npm install -g hubify)
  • Hubify initialized in your project (hubify init)

Setup

1. Initialize Hubify

cd your-project
hubify init

2. Install Skills

hubify install typescript-strict-mode react-best-practices

3. Configure Claude Code

Add to your ~/.claude/claude.md or project’s CLAUDE.md:
## Hubify Skills

This project uses Hubify for AI skill management.

### Available Skills

Run `hubify list` to see installed skills.

### Using Skills

When working on tasks, check for relevant Hubify skills:

1. Search: `hubify search "<task description>"`
2. View: `hubify info <skill-name> --prompt`
3. Execute: Follow the skill's instructions
4. Report: `hubify report <skill-name> --success/--fail`

### Installed Skills

- typescript-strict-mode: TypeScript configuration
- react-best-practices: React development patterns

Usage Patterns

Search for Skills

When you encounter a task, search for relevant skills:
hubify search "api error handling"

Read Skill Content

Get the full skill prompt to incorporate into your work:
hubify info api-error-handling --prompt

Execute Skills

For skills with executable components:
hubify execute api-error-handling --context "Express.js API"

Report Results

After using a skill, report your experience:
# Success
hubify report api-error-handling --success

# With improvement suggestion
hubify report api-error-handling --success \
  --improvement "Add examples for async/await error handling"

# Failure
hubify report api-error-handling --fail \
  --error "Did not handle streaming responses"

Automatic Integration

Using .hubify/config.yaml

Configure automatic skill loading:
# .hubify/config.yaml
platform: claude-code

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

reporting:
  enabled: true
  auto_report: false  # Prompt before reporting

context:
  include_skills_in_prompt: true

Project-Level Configuration

Add to your project’s CLAUDE.md:
## Project Skills

This project uses the following Hubify skills:

### Coding Standards
- `typescript-strict-mode` - Enforce strict TypeScript
- `eslint-config-recommended` - ESLint configuration

### Security
- `security-checklist` - Security review checklist
- `input-validation` - Input sanitization patterns

### Workflow
- `pr-review-checklist` - Pull request reviews
- `commit-message-format` - Commit conventions

When working on relevant tasks, reference these skills using:
`hubify info <skill-name> --prompt`

Example Workflow

1. Start a Task

User: Add TypeScript strict mode to this Next.js project

2. Check for Skills

hubify search "typescript strict mode"

3. Read the Skill

hubify info typescript-strict-mode --prompt

4. Apply the Skill

Follow the skill’s instructions to configure TypeScript.

5. Report Success

hubify report typescript-strict-mode --success \
  --note "Applied to Next.js 14 project with app router"

Tips

Skill Discovery

Add skill discovery to your workflow:
## Claude Code Workflow

Before starting any significant task:
1. Run `hubify search "<task>"` to find relevant skills
2. Review top matches with `hubify info <skill> --prompt`
3. Apply skill guidance to the task
4. Report results with `hubify report <skill> --success/--fail`

Combining Skills

Multiple skills can be used together:
# Install related skills
hubify install typescript-strict-mode eslint-typescript prettier-config

# View all for a task
hubify info typescript-strict-mode --prompt
hubify info eslint-typescript --prompt
hubify info prettier-config --prompt

Using Souls

Apply a personality template:
hubify soul apply pragmatic-engineer
Then add to CLAUDE.md:
## Agent Personality

Using the `pragmatic-engineer` soul:
- Prefer simple solutions
- Consider maintenance costs
- Document decisions

Environment Variables

Set these for advanced features:
export HUBIFY_AGENT_ID=agent_your_id
export CONVEX_URL=https://your-deployment.convex.cloud

Troubleshooting

Skills Not Found

hubify doctor

Check Installation

hubify list

Update Skills

hubify update

Next Steps