The premier operating system for AI coding agents — standardize, compose, and scale skills-as-code.
Project description
⚡ Skillsmith: The Agentic OS
The Infrastructure Layer for AI-Assisted Engineering
Standardize instructions. Evolve skills. Orchestrate swarms.
🚀 v1.1.2 Update: 100/100 Readiness Gate & Stabilized Docs Nexus.
Overview • Competitive Moat • Quick Start • Pillars • Command Reference
🚀 The Vision
Skillsmith isn't just a linter or a template generator. It is the Intelligence Backbone for professional engineering teams in the era of Agentic AI.
While LLMs are powerful, they are context-poor and structurally drift. Skillsmith solves this by turning static codebase rules into dynamic, Self-Evolving Skills-as-Code. It bridges the gap between raw AI inference and production-grade software delivery.
🛡️ The Competitive Moat
Skillsmith v1.0 introduces features that place it at the absolute frontier of AI engineering:
🌍 Ecosystem Discovery (CLI Hub)
Stop hunting for prompts. Use skillsmith search to query the sovereign Ghost-Content index of 889+ skills directly from your terminal. See global categories, filter by tech stack, and install them instantly.
🐝 Multi-Agent Swarm Orchestration
Stop running in single-agent loops. Skillsmith can decompose massive goals into Parallelized Task Graphs (skillsmith swarm plan), assigning specialized roles (Orchestrator, Researcher, Implementer, Reviewer) to coordinate complex missions across multiple agent threads via skillsmith team-exec.
🧬 Autonomous Self-Healing (v1.1.0+)
Skillsmith now autonomously detects performance regressions. If a benchmark score falls below threshold, the Self-Correction Loop automatically generates repair packets and applies logic patches to your SKILL.md library.
🔌 MCP Native Support (Zero Context Bloat)
Expose your entire skill library to any AI tool (Claude Desktop, Cursor, Gemini) via the Skillsmith MCP Server.
# Start the MCP server (stdio for local agents)
skillsmith serve
🌲 Recursive Thinking Trees
When a strategy fails, Skillsmith doesn't just retry. It uses recursive AND/OR Thinking Trees (skillsmith tree) to resolve goals, exploring multiple implementation paths and strategy fallbacks before a single line of bad code is written.
🏁 High-Velocity Setup
1. Install
# Standard installation
pip install skillsmith
# Or with full MCP support (for Claude/Cursor integration)
pip install "skillsmith[mcp]"
2. Initialize (Sovereign Ghost-Sync)
# Sync 889+ expert skill packs natively
skillsmith init --bundle python-pro
3. Evolve & Self-Heal (v1.1.0) 🌌🧪
Skillsmith now monitors its own accuracy.
# Run benchmark and auto-repair degraded skills
skillsmith eval --auto-evolve
# Manually trigger a fix for a specific skill
skillsmith evolve --mode fix --name python-expert
4. Serve your Library (MCP) 🔌
Expose your skills to external agents with on-demand retrieval.
skillsmith serve --transport http --port 3333
4. Align & Certify
# Keeps your Claude commands, Cursor rules, and IDE instructions 100% in sync.
skillsmith align
skillsmith doctor
4. Deploy a Swarm
# Decompose a complex mission into a parallel multi-agent plan.
**skillsmith swarm plan "Refactor the entire auth module for OAuth2 parity"**
5. The Readiness Gate (100/100)
Ensure your repository is technically, architecturally, and doc-ready for agent missions.
# Verify 4 key gates: Init, Doctor, Compose, and Report.
skillsmith ready
🏗️ Architectural Pillars
| Pillar | Focus | Capability |
|---|---|---|
| Pillar 1: Structural Integrity | Zero Drift | Unified instructions across Claude, Cursor, Windsurf, Zencoder, Copilot. |
| Pillar 2: Autonomous Evolution | Self-Improvement | Skills that auto-learn from history and code structures (XSkill/EvoSkill). |
| Pillar 3: Team Intelligence | Swarm Logic | Role-based execution with structured handoffs and verification loops. |
🌍 Codebase Knowledge (CK) Bridge
Skillsmith now integrates Architectural Intelligence through the CK Bridge. By running skillsmith understand sync --deep, the system builds a high-fidelity Knowledge Graph of your repository, enabling subagents to detect architectural hotspots before they plan a mission.
🍱 Onboarding & Documentation
For new users and teams, we have introduced a comprehensive learning path:
- Bit-by-Bit Guide: A level-up journey from basic induction to autonomous evolution.
- The Mission Cookbook: 50+ real-world recipes (Goal/Tools/Recipe/Signal) for building complex software.
- Command Registry: Full 77+ command map (CLI + Slash).
🤖 Power Commands for Top-Tier Performance
skillsmith start— Bootstrap a new repo to readiness in one command.skillsmith commands— Unified God-View of all 77+ terminal and chat commands.skillsmith cookbook— Instant preview of mission recipes.skillsmith understand— Sync architectural intelligence (CK).
📈 Roadmap: The Path to v2.0
- v0.9: Autonomous Evolution (XSkill Phase 1)
- v1.0: Competitive Evolution (Swarms & Thinking Trees)
- v1.1: Self-Healing Skills & MCP Integration
- v1.1.2: 100/100 Readiness Gate & Fixed Docs Nexus
- v2.0: The Collective — Decentralized skill sharing & autonomous agent economies.
📄 License
MIT © ApexIQ
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file skillsmith-1.1.6.tar.gz.
File metadata
- Download URL: skillsmith-1.1.6.tar.gz
- Upload date:
- Size: 344.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f7ba2e0e59b706fb2c89fcf7321455064e7140a3983c4565768a3d46e2fdedcd
|
|
| MD5 |
e4dc6c60d859f7ac1a882085b5aba48b
|
|
| BLAKE2b-256 |
2df9edcdacda63f6df6fc68d4d1a70d9dfcb46cd59e6a593518ba6b365526cd5
|
File details
Details for the file skillsmith-1.1.6-py3-none-any.whl.
File metadata
- Download URL: skillsmith-1.1.6-py3-none-any.whl
- Upload date:
- Size: 406.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8cf4b42df4b11ffc71c876c2d48a5e8d96795cebda2854bb60363edc9f8b3452
|
|
| MD5 |
a663e65e96e2fddc198ed0a88566863d
|
|
| BLAKE2b-256 |
15024cca3e1061121eb0e8edf1ca5c24461ad953d1072d75dfb4e87b613c6703
|