Cursor Integration

Cursor is an AI-powered code editor. This guide shows how to integrate Hubify skills with Cursor.

Prerequisites

• Cursor installed
• 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 Cursor Rules

Create or update .cursorrules in your project:

# Hubify Skills Integration

This project uses Hubify for AI skill management.

## Available Commands

- `hubify search "<query>"` - Find relevant skills
- `hubify info <skill> --prompt` - View skill instructions
- `hubify report <skill> --success/--fail` - Report results

## Installed Skills

When working on tasks, check for Hubify skills that can help:

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

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

## Workflow

1. Before complex tasks, search: `hubify search "<task>"`
2. Apply skill guidance to your work
3. Report results to help skills improve

Using Rules Files

Project Rules (.cursorrules)

# Project: My App

## Tech Stack
- Next.js 14
- TypeScript (strict mode)
- Tailwind CSS

## Hubify Skills

Use these skills for coding guidance:

### TypeScript
When configuring TypeScript, reference:
`hubify info typescript-strict-mode --prompt`

### React
For React components, reference:
`hubify info react-best-practices --prompt`

### Security
Before deploying, run:
`hubify info security-checklist --prompt`

Composer Integration

When using Cursor Composer, include skill references:

@workspace Use the typescript-strict-mode skill from Hubify to configure this project's TypeScript settings.

First, run: hubify info typescript-strict-mode --prompt

Then apply those guidelines to tsconfig.json.

Automatic Skill Loading

Terminal Integration

Open Cursor's integrated terminal and use Hubify directly:

# Search for skills
hubify search "api design"

# View skill
hubify info rest-api-patterns --prompt

# Report after using
hubify report rest-api-patterns --success

Task-Based Workflow

1. Identify Task: User requests a feature
2. Search Skills: hubify search "feature type"
3. Load Skill: hubify info <skill> --prompt
4. Apply: Use skill guidance in implementation
5. Report: hubify report <skill> --success

Cursor Settings

Add to .cursor/settings.json:

{
  "hubify": {
    "enabled": true,
    "autoSuggest": true,
    "defaultSkills": [
      "typescript-strict-mode",
      "react-best-practices"
    ]
  }
}

Example Workflows

Code Review

@workspace Review this PR using Hubify's pr-review-checklist skill.

Run: hubify info pr-review-checklist --prompt

Apply the checklist to review the changes in this PR.

New Feature

@workspace I need to add authentication to this Next.js app.

First, search for relevant Hubify skills:
hubify search "nextjs authentication"

Then apply the best matching skill's guidance.

Refactoring

@workspace Refactor this component following React best practices.

Use: hubify info react-best-practices --prompt

Apply those patterns to improve the component.

Combining with Cursor Features

With @docs

@docs typescript
@workspace Apply TypeScript strict mode using Hubify's guidance:
hubify info typescript-strict-mode --prompt

With @codebase

@codebase Find all API endpoints
@workspace Apply Hubify's rest-api-patterns skill to improve them:
hubify info rest-api-patterns --prompt

Soul Integration

Apply agent personalities:

hubify soul apply pragmatic-engineer

Add to .cursorrules:

## Agent Personality

Using Hubify soul: pragmatic-engineer

- Prefer simple solutions over clever ones
- Consider long-term maintenance
- Document the "why" behind decisions

Tips

Skill Discovery Prompt

Add to your .cursorrules:

## Skill Discovery

Before starting any significant coding task:
1. Check for relevant Hubify skills
2. Apply skill guidance to your work
3. Report results after completion

Commands:
- Search: `hubify search "<task description>"`
- View: `hubify info <skill-name> --prompt`
- Report: `hubify report <skill-name> --success/--fail`

Keyboard Shortcut

Set up a keyboard shortcut to open terminal and search:

1. Open Command Palette (Cmd+Shift+P)
2. Search for "Terminal: Create New Terminal"
3. Assign a shortcut
4. Use it to quickly run Hubify commands

Troubleshooting

Skills Not Loading

hubify doctor

Check Installed Skills

hubify list

Update Skills

hubify update

Next Steps