Metadata-Version: 2.4
Name: dhub-cli
Version: 0.8.0
Summary: The AI Skill Manager for Data Science Agents
Project-URL: Homepage, https://github.com/pymc-labs/decision-hub
Project-URL: Repository, https://github.com/pymc-labs/decision-hub
Project-URL: Issues, https://github.com/pymc-labs/decision-hub/issues
Author-email: PyMC Labs <info@pymc-labs.com>
License-Expression: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.11
Requires-Dist: dhub-core==0.2.3
Requires-Dist: httpx>=0.27.0
Requires-Dist: pyyaml>=6.0.0
Requires-Dist: rich>=13.0.0
Requires-Dist: typer>=0.12.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: respx>=0.21.0; extra == 'dev'
Description-Content-Type: text/markdown

# dhub-cli: The AI Skill Manager

**Decision Hub** is a registry for publishing, discovering, and installing *Skills* — modular packages of code and prompts that AI coding agents (Claude, Cursor, Codex, Gemini, OpenCode) can use.

**Browse the registry at [hub.decision.ai](https://hub.decision.ai)** or use the CLI below.

## Why Decision Hub?

**Agents that extend themselves.** Install Decision Hub as a skill into any supported agent, and the agent can discover new skills in natural language — then install and use them mid-conversation without human intervention.

**Publish from anywhere.** Point `dhub publish` at a local directory or a GitHub repo URL and every valid `SKILL.md` inside is discovered, versioned, and published.

**Private skills for your team.** Skills can be scoped to your GitHub organization so proprietary tooling stays internal.

**Install once, use everywhere.** A single `dhub install` symlinks a skill into every agent's skill directory — Claude, Cursor, Codex, Gemini, OpenCode. No duplication, no per-agent setup.

**Security gauntlet.** Every publish is scanned for dangerous patterns. Skills get a trust grade (A/B/C/F) before they reach the registry.

**Automated evals in sandboxes.** Skills ship with eval cases that run on publish in isolated sandboxes, scored by an LLM judge.

**Executable skills with SKILL.md.** Builds on the [Agent Skills spec](https://agentskills.io/specification) with `runtime` and `evals` blocks — skills are runnable programs, not just static prompts.

## Installation

```bash
# Via uv (recommended)
uv tool install dhub-cli

# Via pipx
pipx install dhub-cli
```

## Quick Start

```bash
# 1. Authenticate via GitHub
dhub login

# 2. Search for skills using natural language
dhub ask "analyze A/B test results"

# 3. Install a skill for all your agents
dhub install pymc-labs/causalpy

# 4. Scaffold a new skill
dhub init my-new-skill

# 5. Publish it under your namespace
# (Run this inside the skill directory)
dhub publish .
```

## Supported Agents

Skills are installed as symlinks into each agent's skill directory, making them immediately available:

- **Claude:** `~/.claude/skills`
- **Cursor:** `~/.cursor/skills`
- **Codex:** `~/.codex/skills`
- **Gemini:** `~/.gemini/skills`
- **OpenCode:** `~/.config/opencode/skills`

## Documentation

For full documentation on creating skills, the `SKILL.md` format, and running your own registry server, see the [main repository](https://github.com/pymc-labs/decision-hub).