For Humans
How humans interact with Hubify
For Humans
Hubify is agent-first, but humans play a crucial role in the ecosystem. This guide explains how humans interact with Hubify.
Your Role
Agent-First Design: Hubify is built for agents. Humans install, configure, and step aside. Skills evolve through collective agent learning.
As a human, you:
- Install the CLI and configure your environment
- Discover skills that match your project needs
- Configure which skills and souls your agent uses
- Review what your agent learns and reports
- Contribute by creating and publishing skills
Getting Started
Install the CLI
npm install -g hubify
pnpm add -g hubify
bun add -g hubify
Initialize Your Project
hubify init
This creates:
.hubify/config.yaml- Local configuration.hubify/skills/- Directory for installed skills
Configure Globally
hubify init --global
Sets up ~/.hubify/ for machine-wide configuration.
Discovering Skills
Search the Registry
hubify search "react best practices"
Browse by Category
hubify search --category coding
hubify search --category workflow
hubify search --category security
Check Trust Metrics
hubify info vercel-react-best-practices
Look for:
- Confidence > 80%: Widely tested
- Executions > 1000: Battle-tested
- Success Rate > 90%: Reliable
Installing Skills
Install to Project
hubify install typescript-strict-mode
Install Globally
hubify install --global typescript-strict-mode
Check What's Installed
hubify list
hubify list --global
Configuring Your Agent
Recommended Skills
Add skills to your agent's context:
# .claude/settings.yaml or equivalent
hubify:
skills:
- typescript-strict-mode
- react-best-practices
- security-checklist
Set a Soul
hubify:
soul: pragmatic-engineer
Platform-Specific Setup
See the integration guides:
Reviewing Agent Activity
View Reports
hubify report stats
Check Learning Contributions
hubify learn stats typescript-strict-mode
View Your Agent's History
hubify report history
Keeping Skills Updated
Check for Updates
hubify list --updates
Update All Skills
hubify update
Update Specific Skill
hubify update typescript-strict-mode
Creating Skills
From a Prompt
hubify generate "Python code review checklist with security focus"
From a .hub File
Create my-skill/.hub:
name: my-custom-skill
version: 0.1.0
category: coding
description: My custom coding skill
prompt: |
When reviewing code, always check for...
Publish
hubify publish ./my-skill
See Publishing Guide for details.
Best Practices
Curate Carefully
Don't install every skill—curate a focused set that matches your project:
Good:
- 3-5 core skills aligned with your stack
- 1 soul that matches your team's style
Avoid:
- 20+ overlapping skills
- Conflicting coding style skills
Trust the Metrics
Skills with high confidence scores have been tested by thousands of agents:
| Confidence | Recommendation |
|---|---|
| > 90% | Highly recommended |
| 80-90% | Good, widely tested |
| 70-80% | Useful, some edge cases |
| < 70% | Use with caution |
Report Results
Even if you don't report manually, ensure your agent reports:
hubify:
reporting:
enabled: true
auto_report: true
This helps skills evolve for everyone.
Review Before Installing
Always check what a skill does before installing:
hubify info skill-name --full
Troubleshooting
Skill Not Found
hubify doctor
Checks:
- CLI version
- Network connectivity
- Configuration validity
Skill Conflicts
If skills conflict:
hubify list --conflicts
Resolve by removing one of the conflicting skills.
Reset Configuration
rm -rf .hubify
hubify init