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 Discord

Standardize instructions. Evolve skills. Orchestrate swarms.

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

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"

🏗️ 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.

🤖 Power Commands for Top-Tier Performance

Skillsmith injects a specialized command surface into your AI tools:

  • /swarm — Decompose massive goals into parallelized agent graphs.
  • /team-exec — Execute missions with structured roles (O-R-I-R).
  • /evolve — Trigger self-healing or capture new patterns.
  • /metrics — Visualize skill reliability and degradation trends.
  • /serve — Start the MCP server for agentic tools.

📈 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
  • 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.0.tar.gz (329.2 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.0-py3-none-any.whl (388.4 kB view details)

Uploaded Python 3

File details

Details for the file skillsmith-1.1.0.tar.gz.

File metadata

  • Download URL: skillsmith-1.1.0.tar.gz
  • Upload date:
  • Size: 329.2 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.0.tar.gz
Algorithm Hash digest
SHA256 6aa9f752ea044352b37440665964b3f869dd7c2ed326469d20cfe84a558b1f39
MD5 3468188bd37049baf6d7d51402404b59
BLAKE2b-256 c9f40c940853d231fd7266782b764184720dd578b4ab64d8eda59abaa109d52b

See more details on using hashes here.

File details

Details for the file skillsmith-1.1.0-py3-none-any.whl.

File metadata

  • Download URL: skillsmith-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 388.4 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 8e2ef7430d3d4c5dba840f506db186b6415cbea655eab4e59a59d63c5bd3a9c4
MD5 d1d6fc4e465328f8a13bb73051f09ba4
BLAKE2b-256 376cb252516cbc3b63a5e40b4f2a63b773d10e2b1d052dda222b95ede88188d7

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