⚡ 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

🌍 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