hubify 0.2.0 → 0.4.0

package/README.md

@@ -0,0 +1,151 @@
+# hubify
+
+The living intelligence layer for AI Agent Skills.
+
+[![npm version](https://img.shields.io/npm/v/hubify.svg)](https://www.npmjs.com/package/hubify)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## What is Hubify?
+
+Hubify is the universal registry for AI agent skills. Skills are verified, evolving, and collective - every execution makes the whole network smarter.
+
+- **Search** 40,000+ verified skills
+- **Install** skills locally for your agents
+- **Execute** and track results
+- **Generate** new skills with AI
+- **Report** execution outcomes to improve the collective
+
+## Installation
+
+```bash
+npm install -g hubify
+```
+
+Or use directly with npx:
+
+```bash
+npx hubify search react
+```
+
+## Quick Start
+
+```bash
+# Search for skills
+hubify search "deploy kubernetes"
+
+# Install a skill
+hubify install kubernetes-deploy
+
+# Execute a skill (outputs instructions for your agent)
+hubify execute kubernetes-deploy
+
+# Report execution results
+hubify report kubernetes-deploy --success
+
+# Generate a new skill with AI
+hubify generate "a skill for optimizing PostgreSQL queries"
+```
+
+## Commands
+
+### Discovery
+
+| Command | Description |
+|---------|-------------|
+| `hubify search <query>` | Search skills by name, description, or tags |
+| `hubify info <skill>` | View detailed skill information and trust metrics |
+| `hubify stats` | View registry-wide statistics |
+
+### Installation & Execution
+
+| Command | Description |
+|---------|-------------|
+| `hubify install <skill>` | Install skill(s) locally |
+| `hubify execute <skill>` | Execute a skill and output instructions |
+| `hubify list` | List installed skills |
+| `hubify update [skill]` | Update installed skills |
+
+### Publishing & Generation
+
+| Command | Description |
+|---------|-------------|
+| `hubify init` | Initialize Hubify in your project |
+| `hubify publish <path>` | Publish a skill to the registry |
+| `hubify generate <prompt>` | Generate a new skill with AI |
+| `hubify import <url>` | Import skills from GitHub |
+
+### Analytics
+
+| Command | Description |
+|---------|-------------|
+| `hubify report <skill>` | Report execution results |
+| `hubify report stats` | View execution statistics |
+| `hubify report leaderboard` | Top skills by executions |
+
+## Trust Metrics
+
+Every skill has trust metrics based on real executions:
+
+- **Confidence Score** (0-100%) - Based on success rate across all executions
+- **Verification Level** (L0-L3) - From untested to battle-tested
+- **Execution Count** - Total times the skill has been run
+- **Success Rate** - Percentage of successful executions
+
+```bash
+hubify info react-best-practices
+
+# Trust Metrics
+# Confidence:     ████████████████░░░░ 82%
+# Level:          L2 Verified
+# Success Rate:   ████████████████████ 94%
+# Executions:     12,847
+```
+
+## AI Skill Generation
+
+Generate new skills from natural language:
+
+```bash
+# Uses Claude API (requires ANTHROPIC_API_KEY)
+hubify generate "automate Docker container deployments with health checks"
+
+# Or use template-based generation (no API needed)
+hubify generate "lint TypeScript code" --template
+```
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `ANTHROPIC_API_KEY` | Required for AI skill generation |
+| `GITHUB_TOKEN` | Optional, for higher GitHub API rate limits |
+
+## Configuration
+
+Initialize project or global config:
+
+```bash
+# Project config (.hubify/config.yaml)
+hubify init
+
+# Global config (~/.hubify/config.yaml)
+hubify init --global
+```
+
+## How It Works
+
+1. **Agent executes a skill** → Instructions guide the agent
+2. **Results reported back** → Success/failure tracked
+3. **Collective improves** → Trust scores update, everyone benefits
+
+Skills aren't static - they're living entities that improve from collective feedback.
+
+## Links
+
+- **Website**: [hubify.com](https://hubify.com)
+- **Registry**: [hubify.com/skills](https://hubify.com/skills)
+- **GitHub**: [github.com/houstongolden/hubify](https://github.com/houstongolden/hubify)
+
+## License
+
+MIT © [Houston Golden](https://github.com/houstongolden)