skillhub-ai 0.1.0__tar.gz

skillhub_ai-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,35 @@
+## Skill Name
+
+<!-- The exact name from skill.json -->
+
+## Problem This Solves
+
+<!-- Describe the specific situation where you needed this skill and it didn't exist.
+     "This could be useful" is not a problem statement.
+     "I was building a RAG pipeline and had no systematic way to evaluate faithfulness" is. -->
+
+## What the Skill Does
+
+<!-- The workflow the skill provides. Not a list of the file's contents. -->
+
+## Checklist
+
+- [ ] `skills/<name>/SKILL.md` exists with valid frontmatter (name, description, version, agents, tags)
+- [ ] `skills/<name>/skill.json` exists with all required fields
+- [ ] Entry added to `registry/index.json` in alphabetical order
+- [ ] Skill name is lowercase-hyphen-separated and matches the directory name
+- [ ] Description is under 1024 characters and includes "Use when..."
+- [ ] Skill is under 500 lines (or uses supporting files for overflow)
+- [ ] I searched for existing skills and this doesn't duplicate one: `skillhub search <topic>`
+- [ ] This is a single skill (not multiple skills bundled together)
+
+## Authoring
+
+<!-- Required: who wrote this? -->
+- [ ] Written by hand (no AI assistance)
+- [ ] AI-assisted — model used: __________, I reviewed the complete diff before submitting
+
+## Existing PRs / Issues
+
+<!-- Search open AND closed PRs for this skill or related ones. What did you find?
+     If a prior PR was closed, what's different about this one? -->

skillhub_ai-0.1.0/.gitignore

@@ -0,0 +1,12 @@
+__pycache__/
+*.pyc
+*.pyo
+.env
+.venv/
+venv/
+dist/
+build/
+*.egg-info/
+.pytest_cache/
+.mypy_cache/
+~/.skillhub/

skillhub_ai-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,110 @@
+# Contributing to skillhub
+
+Skills are reviewed for quality before merging. One excellent skill is worth ten mediocre ones.
+
+## Before You Submit
+
+Ask yourself:
+- **Is this skill genuinely useful to other developers?** Not just to me, not just for my project.
+- **Does it describe a workflow, not just facts?** Skills are processes, not reference docs.
+- **Is it specific and actionable?** "Run `npm test`" beats "verify the tests work."
+
+If yes to all three — welcome.
+
+## What We Will Not Accept
+
+- Skills that only work for one specific company's stack
+- Skills that add third-party service dependencies without a fallback
+- Rewrites of existing skills without clear improvement evidence
+- Duplicate skills (search first: `skillhub search <topic>`)
+- Bulk submissions (one skill per PR, understood deeply)
+
+## Skill Format
+
+Every skill is a folder under `skills/` containing:
+
+```
+skills/
+  your-skill-name/
+    SKILL.md       ← required
+    skill.json     ← required
+```
+
+### SKILL.md frontmatter (required)
+
+```yaml
+---
+name: your-skill-name
+description: What this skill does and when to use it. Max 1024 chars.
+version: 1.0.0
+agents: [claude, cursor, codex, gemini]
+tags: [tag1, tag2, tag3]
+---
+```
+
+### skill.json (required)
+
+```json
+{
+  "name": "your-skill-name",
+  "display_name": "Your Skill Name",
+  "description": "One-line description for the registry listing.",
+  "version": "1.0.0",
+  "agents": ["claude", "cursor", "codex", "gemini"],
+  "tags": ["tag1", "tag2"],
+  "author": "your-github-username",
+  "license": "MIT"
+}
+```
+
+### registry/index.json entry (required)
+
+Add your skill to `registry/index.json` in alphabetical order:
+
+```json
+{
+  "name": "your-skill-name",
+  "display_name": "Your Skill Name",
+  "description": "One-line description.",
+  "version": "1.0.0",
+  "agents": ["claude", "cursor", "codex", "gemini"],
+  "tags": ["tag1", "tag2"],
+  "author": "your-github-username",
+  "license": "MIT"
+}
+```
+
+## PR Requirements
+
+1. **One skill per PR.** Split multiple skills into separate PRs.
+2. **Fill in the PR template completely.** Empty sections = closed PR.
+3. **A human must review the diff before submitting.** If an AI wrote it, you reviewed it.
+4. **Disclose your authoring environment** in the PR: wrote by hand, or which AI tool helped.
+5. **Real problem only.** Describe the specific scenario where you needed this skill and it didn't exist.
+
+## Skill Quality Bar
+
+Read `skills/research-agent/SKILL.md` and `skills/code-reviewer/SKILL.md` as examples of the quality bar.
+
+Key properties of a good skill:
+- **Process over knowledge**: steps to follow, not facts to memorize
+- **Specific over general**: exact commands and outputs, not "run the tests"
+- **Anti-rationalization**: every step that could be skipped has a rebuttal
+- **Verification**: checklist of exit criteria with evidence requirements
+- **Under 500 lines**: if longer, split into a main skill + supporting files
+
+## Development Setup
+
+```bash
+git clone https://github.com/chandrudp29/skillhub
+cd skillhub
+pip install -e ".[dev]"
+
+# Verify the CLI works
+skillhub list
+skillhub install research-agent
+```
+
+## Questions
+
+Open an issue before starting work on a large skill — saves you time if it's already in progress.

skillhub_ai-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chandrashekar DP
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

skillhub_ai-0.1.0/PKG-INFO

@@ -0,0 +1,348 @@
+Metadata-Version: 2.4
+Name: skillhub-ai
+Version: 0.1.0
+Summary: The package manager for AI agent skills — install, compose, and publish skills for Claude Code, Cursor, Codex, and Gemini CLI
+Project-URL: Homepage, https://github.com/chandrudp29/skillhub
+Project-URL: Repository, https://github.com/chandrudp29/skillhub
+Project-URL: Issues, https://github.com/chandrudp29/skillhub/issues
+Project-URL: Changelog, https://github.com/chandrudp29/skillhub/blob/main/CHANGELOG.md
+Author-email: Chandrashekar DP <chandrudp29@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: agents,ai,claude,claude-code,codex,cursor,gemini,llm,package-manager,skills
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.12.0
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# skillhub
+
+[![PyPI version](https://img.shields.io/pypi/v/skillhub-ai.svg)](https://pypi.org/project/skillhub-ai/)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![Skills](https://img.shields.io/badge/skills-22-purple.svg)](#available-skills)
+
+**The package manager for AI agent skills.**
+
+Install, compose, and publish reusable prompting workflows for Claude Code, Cursor, Codex, and Gemini CLI — in one command.
+
+```bash
+pip install skillhub-ai
+skillhub install research-agent
+```
+
+---
+
+## Why skillhub?
+
+You've been copying skill files manually:
+
+```bash
+# The old way
+git clone https://github.com/someone/skills
+cp skills/research-agent/SKILL.md .claude/commands/
+cp skills/research-agent/SKILL.md .cursor/rules/
+# repeat for every skill, every project, every agent...
+```
+
+No versioning. No search. No way to combine skills. Every agent needs different files in different places.
+
+**skillhub fixes this:**
+
+```bash
+# The new way
+skillhub install research-agent --all-agents  # Done. All 4 agents configured.
+```
+
+---
+
+## Installation
+
+```bash
+pip install skillhub-ai
+```
+
+Requires Python 3.9+. No other dependencies needed.
+
+**Verify installation:**
+```bash
+skillhub --help
+```
+
+---
+
+## Quick Start
+
+### Search & Discover
+
+```bash
+# Search by keyword
+skillhub search "debug"
+
+# Search by tag
+skillhub search "research" --tag analysis
+
+# List all 22 available skills
+skillhub list
+
+# Get detailed info on a skill
+skillhub info research-agent
+```
+
+### Install Skills
+
+```bash
+# Install for Claude Code (default)
+skillhub install research-agent
+
+# Install for a specific agent
+skillhub install debug-agent --agent cursor
+skillhub install debug-agent --agent codex
+skillhub install debug-agent --agent gemini
+
+# Install for ALL agents at once
+skillhub install debug-agent --all-agents
+
+# Preview what will be installed (no changes made)
+skillhub install debug-agent --dry-run
+```
+
+### Manage Installed Skills
+
+```bash
+# See what's installed in this project
+skillhub list --installed
+
+# Update all installed skills to latest
+skillhub update
+
+# Remove a skill
+skillhub uninstall debug-agent
+```
+
+---
+
+## Skill Composer (The Killer Feature)
+
+Combine multiple skills into one unified file — conflicts resolved automatically:
+
+```bash
+skillhub compose research-agent code-reviewer security-review -o my-review-skill
+```
+
+**What it does:**
+- Merges descriptions from all skills
+- Combines sections without duplication
+- Detects conflicts (first-writer wins)
+- Reports what was merged
+
+**Preview first:**
+```bash
+skillhub compose debug-agent test-writer --dry-run -o qa-skill
+```
+
+---
+
+## Available Skills (22)
+
+### Research & Analysis
+| Skill | Description |
+|-------|-------------|
+| `research-agent` | Multi-source deep research with synthesis and citations |
+| `rag-evaluator` | Evaluate RAG pipelines: faithfulness, relevance, hallucination |
+| `llm-evaluator` | Build evaluation frameworks for LLM outputs |
+
+### Code Quality
+| Skill | Description |
+|-------|-------------|
+| `code-reviewer` | Five-axis code review (correctness, security, performance, readability, maintainability) |
+| `debug-agent` | Systematic root cause analysis — feedback loop first |
+| `refactor-agent` | Safe, incremental refactoring with verification |
+| `test-writer` | Write meaningful tests that actually catch bugs |
+| `security-review` | OWASP-based security auditing |
+
+### Documentation
+| Skill | Description |
+|-------|-------------|
+| `doc-generator` | README, API docs, docstrings, changelogs |
+| `pr-summarizer` | Generate PR descriptions: what, why, how, risks |
+
+### Development Patterns
+| Skill | Description |
+|-------|-------------|
+| `python-patterns` | Modern Python best practices (typing, async, dataclasses) |
+| `react-patterns` | React 18+ patterns (hooks, suspense, server components) |
+| `fastapi-patterns` | Production FastAPI patterns |
+| `api-design` | REST API conventions and best practices |
+| `sql-agent` | Write, optimize, and explain SQL with query plans |
+
+### DevOps
+| Skill | Description |
+|-------|-------------|
+| `docker-agent` | Dockerfile optimization, multi-stage builds |
+| `git-workflow` | Branching strategies, commit conventions |
+
+### AI/ML Engineering
+| Skill | Description |
+|-------|-------------|
+| `agent-builder` | Build LangGraph agents with proper patterns |
+| `prompt-optimizer` | Diagnose and improve underperforming prompts |
+| `mle-workflow` | Production ML workflow: data, training, deployment |
+| `cost-tracker` | Track and optimize LLM API costs |
+
+### Career
+| Skill | Description |
+|-------|-------------|
+| `yc-job-tracker` | Daily AI/ML job tracking at YC startups |
+
+```bash
+skillhub list         # See all with descriptions
+skillhub info <name>  # Full details on one skill
+```
+
+---
+
+## Supported Agents
+
+| Agent | Install Path | Flag |
+|-------|--------------|------|
+| **Claude Code** | `.claude/commands/{name}.md` | default |
+| **Cursor** | `.cursor/rules/{name}.mdc` | `--agent cursor` |
+| **OpenAI Codex** | `AGENTS.md` (appended) | `--agent codex` |
+| **Gemini CLI** | `.gemini/skills/{name}.md` | `--agent gemini` |
+
+---
+
+## Command Reference
+
+| Command | Description |
+|---------|-------------|
+| `skillhub search <query>` | Find skills by name, description, or tag |
+| `skillhub list` | Show all available skills |
+| `skillhub list --installed` | Show installed skills in current project |
+| `skillhub info <name>` | Detailed information about a skill |
+| `skillhub install <name>` | Install a skill |
+| `skillhub install <name> --dry-run` | Preview install without writing |
+| `skillhub install <name> --all-agents` | Install for all 4 agents |
+| `skillhub uninstall <name>` | Remove an installed skill |
+| `skillhub update` | Update all installed skills |
+| `skillhub compose <a> <b> -o <name>` | Merge multiple skills into one |
+| `skillhub publish <path>` | Submit your skill to the registry |
+
+---
+
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `SKILLHUB_CACHE_TTL` | `3600` | Cache duration in seconds (1 hour) |
+| `SKILLHUB_QUIET` | `0` | Set to `1` to suppress warnings |
+
+---
+
+## How It Works
+
+```
+skillhub install research-agent
+         │
+         ▼
+┌─────────────────────────────────┐
+│  Fetch registry from GitHub     │  (cached 1 hour)
+│  registry/index.json            │
+└─────────────────────────────────┘
+         │
+         ▼
+┌─────────────────────────────────┐
+│  Download SKILL.md for agent    │
+│  skills/research-agent/SKILL.md │
+└─────────────────────────────────┘
+         │
+         ▼
+┌─────────────────────────────────┐
+│  Write to correct agent path    │
+│  .claude/commands/research-agent.md
+└─────────────────────────────────┘
+         │
+         ▼
+      Done! ✓
+```
+
+**Offline support:** Falls back to bundled skills when network is unavailable.
+
+---
+
+## Publish Your Own Skill
+
+Have a skill that would help others? Submit it:
+
+```bash
+skillhub publish ./my-skill
+```
+
+This opens a guided PR flow. See [CONTRIBUTING.md](CONTRIBUTING.md) for the full guide.
+
+**Quality bar:** We review for usefulness, not quantity. One genuinely helpful skill beats ten mediocre ones.
+
+---
+
+## Troubleshooting
+
+**Skill not found?**
+```bash
+skillhub search <partial-name>  # Find similar skills
+skillhub list                   # See everything available
+```
+
+**Already installed error?**
+```bash
+skillhub install <name> --overwrite  # Replace existing
+```
+
+**Network issues?**
+```bash
+# skillhub falls back to bundled skills automatically
+# To force refresh:
+SKILLHUB_CACHE_TTL=0 skillhub list
+```
+
+---
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for the full guide.
+
+**Quick start:**
+1. Fork this repo
+2. Add your skill under `skills/<your-skill-name>/SKILL.md`
+3. Add entry to `registry/index.json`
+4. Open a PR
+
+---
+
+## Author
+
+Built by [Chandrashekar DP](https://github.com/chandrudp29) — AI/ML Engineer building open source tools for developers.
+
+If skillhub saves you time, consider starring it — it helps others find it.
+
+---
+
+## License
+
+MIT