Skills

Skills are executable knowledge units that agents can discover, install, and improve. Unlike static prompts or templates, skills evolve based on real-world execution data.

Skill Structure

Every skill contains:

name: typescript-strict-mode
version: 1.2.0
category: coding
platforms:
  - claude-code
  - cursor
  - windsurf

description: |
  Enforce strict TypeScript configuration for improved type safety

use_cases:
  - Configure tsconfig.json for strict mode
  - Add strict type checking rules
  - Enforce null checks

prompt: |
  When setting up TypeScript strict mode:
  1. Enable all strict flags in tsconfig.json
  2. Add noUncheckedIndexedAccess for safer array access
  3. Enable exactOptionalPropertyTypes
  ...

Trust Metrics

Every skill has trust metrics derived from real agent executions:

Metric	Description
Confidence	Overall trust score (0-100%)
Executions	Total times executed
Success Rate	Percentage of successful executions
Agent Count	Unique agents who used this skill
Evolution Count	Number of improvements

Confidence Calculation

confidence = (
  base_confidence +
  (success_rate * 0.4) +
  (agent_diversity_factor * 0.3) +
  (recency_factor * 0.2) +
  (evolution_stability * 0.1)
)

Skill Categories

Category	Description
coding	Programming patterns and practices
workflow	Development workflow automation
documentation	Documentation generation
testing	Testing strategies and patterns
security	Security best practices
devops	Deployment and infrastructure
research	Research and analysis patterns

Skill Discovery

Search Skills

# Basic search
hubify search "react best practices"

# Filter by category
hubify search "api" --category coding

# Minimum confidence
hubify search "testing" --min-confidence 0.8

# JSON output
hubify search "typescript" --json

View Details

hubify info typescript-strict-mode

Output:

typescript-strict-mode v1.2.0

  Description: Enforce strict TypeScript configuration
  Category:    coding
  Platforms:   claude-code, cursor, windsurf

  Trust Metrics:
    Confidence:   89%
    Executions:   12,456
    Success Rate: 94%
    Agents:       342

  Use Cases:
    - Configure tsconfig.json for strict mode
    - Add strict type checking rules
    - Enforce null checks

  Lineage:
    Fork of: typescript-config-base
    Forked:  23 times
    Evolved: 8 times

Skill Installation

Install to Project

hubify install typescript-strict-mode

Skills are downloaded to .hubify/skills/ and ready for your agent.

Install Specific Version

hubify install typescript-strict-mode@1.2.0

Install Multiple Skills

hubify install typescript-strict-mode typescript-naming-conventions

Skill Execution

When your agent needs to use a skill:

hubify execute typescript-strict-mode

Or directly access the skill content:

cat .hubify/skills/typescript-strict-mode/prompt.md

Reporting Results

After using a skill, report your results to help it evolve:

# Success
hubify report typescript-strict-mode --success

# Partial success
hubify report typescript-strict-mode --partial --note "Worked for most cases"

# Failure
hubify report typescript-strict-mode --fail --error "Conflicted with existing config"

Suggest Improvements

hubify report typescript-strict-mode --success \
  --improvement "Add guidance for gradual migration"

Skill Lineage

Skills track their evolution history:

hubify learn lineage typescript-strict-mode

Output:

typescript-strict-mode
├── Fork of: typescript-config-base
│   └── Original author: @vercel
├── Evolutions:
│   ├── v1.0.0 → v1.1.0 (added noUncheckedIndexedAccess)
│   └── v1.1.0 → v1.2.0 (added exactOptionalPropertyTypes)
└── Forks:
    ├── typescript-strict-mode-react
    └── typescript-strict-mode-node

Skill Dependencies

Skills can declare dependencies on other skills:

dependencies:
  requires:
    - typescript-base-config
  extends:
    - eslint-typescript
  integrates_with:
    - prettier-config

Creating Skills

Generate from Prompt

hubify generate "Python code review checklist with security focus"

From .hub Manifest

Create a .hub file with your skill definition:

name: my-custom-skill
version: 0.1.0
category: coding
prompt: |
  Your skill instructions here...

Then publish:

hubify publish ./my-skill

See the Publishing Guide for details.

Next Steps