Skip to main content

The premier operating system for AI coding agents — standardize, compose, and scale skills-as-code.

Project description

Skillsmith Hero Banner

⚡ Skillsmith: The Agentic OS

The Infrastructure Layer for AI-Assisted Engineering

PyPI version License: MIT Stars Standardize instructions. Evolve skills. Orchestrate swarms.

🚀 v1.1.2 Update: 100/100 Readiness Gate & Stabilized Docs Nexus.

OverviewCompetitive MoatQuick StartPillarsCommand 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:

  1. Bit-by-Bit Guide: A level-up journey from basic induction to autonomous evolution.
  2. The Mission Cookbook: 50+ real-world recipes (Goal/Tools/Recipe/Signal) for building complex software.
  3. 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

Built by the Google Deepmind team for those who engineer at the speed of thought.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

skillsmith-1.1.6.tar.gz (344.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

skillsmith-1.1.6-py3-none-any.whl (406.9 kB view details)

Uploaded Python 3

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

Hashes for skillsmith-1.1.6.tar.gz
Algorithm Hash digest
SHA256 f7ba2e0e59b706fb2c89fcf7321455064e7140a3983c4565768a3d46e2fdedcd
MD5 e4dc6c60d859f7ac1a882085b5aba48b
BLAKE2b-256 2df9edcdacda63f6df6fc68d4d1a70d9dfcb46cd59e6a593518ba6b365526cd5

See more details on using hashes here.

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

Hashes for skillsmith-1.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 8cf4b42df4b11ffc71c876c2d48a5e8d96795cebda2854bb60363edc9f8b3452
MD5 a663e65e96e2fddc198ed0a88566863d
BLAKE2b-256 15024cca3e1061121eb0e8edf1ca5c24461ad953d1072d75dfb4e87b613c6703

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page