Five tasks. One sentence.
Compose ordered stages from a compound request: inspect → diagnose → build → test → explain. Cross domains without manually assembling a stack of skills.
Describe the work. SolKraft matches each requested capability to a reusable procedure, puts the steps in order, and gives your agent the instructions to follow.
Built for work that spans investigation, building, testing, and explaining the result. Ambiguous requests surface a need for clarification.
“Inspect the repository, diagnose the CI failure, implement a fix, run regression tests, and write the PR description.”
Intent becomes an inspectable workflow. Your agent gets the methods it needs, when it needs them.
Compose ordered stages from a compound request: inspect → diagnose → build → test → explain. Cross domains without manually assembling a stack of skills.
Software, research, data, writing, business, mathematics, legal research, and engineering. Discover by capability and inspect the actual instructions.
Search compact metadata first. Retrieve a selected skill and its supporting resources when needed, keeping the full catalog out of the conversation.
Separate active work from exclusions, quoted text, deferred tasks, and delivery context. Ambiguous stages surface a clarification need instead of a pile of plausible skills.
Inspect inputs, outputs, effects, requirements, and trust metadata before loading instructions. Hardened routing rejects inadmissible capabilities. Your agent retains execution authority.
A native Codex plugin, seven read-only MCP tools, a CLI, and a REST API. Run locally without a hosted account or model API key for the service.
A practical layer between your request and your agent’s tools. Discover a method, inspect why it was selected, and retrieve its instructions when they are needed.
Route actions and context without memorizing skill IDs. Scope exclusions, quoted text, deferred work, and delivery requirements are handled separately from active tasks.
Compose methods across domains, preserve requested order, and expose unresolved stages. Review the proposed route before your agent applies it.
Search compact metadata first. Retrieve the selected procedure and supporting resources through REST or MCP, without putting the entire catalog in context.
SolKraft now treats each skill as a compact, inspectable capability contract. The router can reason about what a skill needs, what it may affect, what authority a host would need, how skills connect through typed inputs and outputs, and what evidence would verify success—before loading the full procedure.
Skills can carry typed contract.yaml sidecars with namespaced effects, capability/resource requirements, declarative checks, digests, provenance, and trust state.
Known-inadmissible skills are filtered before they shape a route. Whole routes are validated, broken dependencies are exposed, and one bounded repair pass can substitute a safe alternative.
Typed outputs can satisfy downstream inputs. A unique compatible producer can be inserted automatically; missing or ambiguous inputs remain visible instead of being guessed.
Execution evidence is bound to exact contract and SKILL.md digests. Trust comes from external digest-bound review, never from a skill declaring itself trusted.
Contract metadata is available over REST, MCP and CLI. Portable import/export and conservative MCP/OpenAPI adapters carry declarations only—never authority.
Contributors can run the same reusable full gate locally or from GitHub before opening a PR, including the 100,000-route regression, packaging, installed MCP checks, contract indexing, and hardening receipts.
execution_authorized remains false.
The full local gate requires 473,000 production-router calls across 32 slices: 173,000 single-skill cases, 100,000 clarified compound requests, 100,000 original diagnostic requests, and 100,000 stability calls. Results appear only when the complete exact-match receipt passes.
Acceptance requires 100% exact compound sets, zero extra selections, and no unresolved stages in the clarified corpus. Original requests remain a separate diagnostic.
The receipt proves the stated corpus. Ambiguous original wording is reported separately; a generated test result does not establish perfect matching for arbitrary language, skill execution, or deployment.
Choose a recorded request routed by the same Python engine. The result is precomputed, inspectable, and available without a server.
Custom semantic requests require a connected SolKraft API. Browse and inspect bundled skills here without a connection.
Loading recorded request…
The generated corpus uses catalog-derived semantic anchors without injecting skill IDs or full descriptions. Its locked holdout is generated, not an independent human-language study. The authored regression suite checks everyday requests and scope boundaries separately. All calls use the production router with a frozen catalog; routing outputs are not memoized.
Gates require 100% global, holdout, and per-skill decisions; 100% clarified compound coverage, ordering, and exact sets; zero extra selections and unresolved stages; 100% stability; zero metadata leakage; and complete matching receipts. Clarified requests retain every original topic and target, adding published capability words to distinguish ambiguous intent. All 100,000 unchanged original requests are rerun and disclosed separately.
python -m scripts.local_ci --semantic-proof --semantic-workers 6Read the method and limitations ↗Source identity loads with the receipt.
A skill is a reusable procedure with instructions and supporting resources. The solforge skill contains the orchestration and semantic routing machinery; it is also a node in the selection graph. Specialist skills supply the methods for research, building, testing, writing, and engineering. Capability-preserving execution supplies the adaptive execution loop: frame the outcome, map dependencies, schedule safe work, preserve evidence, repair failures, and verify completion. It is an instruction-based execution layer, not a hidden Python scheduler.
“Inspect the codebase, fix the bug, add a regression test, and verify the release build.”
SolForge reads actions, context, and exclusions. The selection graph supplies workflow relationships.
Codebase investigation → software build → software test. The agent checks the route against your actual intent.
MCP or REST returns the selected instructions and needed references. The entire catalog stays out of the conversation.
The host preserves requirements, follows dependencies, applies the specialist procedure, and adapts when evidence changes.
The agent runs relevant checks, repairs failures, and reports evidence and remaining limits. SolKraft does not certify the result.
Browse the paginated catalog or search names and descriptions. Inspect a skill, then copy its instructions into your agent. This works here without an account or API key.
Try the worked example below. For your own request, connect a SolKraft API and use Compose a route. The result shows stages, selected skills, reasons, and unresolved work.
Copy instructions manually, or let an MCP or REST client retrieve them. Your agent reads the selected procedures, uses its own tools, and verifies the requested result.
Inspect the codebase, fix the bug, add a regression test, and verify the release build. Do not deploy or publish anything.
See the actual parser output generated from this request, inspect its selected procedures, and copy the request for your agent.
The deterministic parser still understands scoped rules, concept aliases, domain context, exclusions, quoted instructions, and completed or deferred work. It also matches published capability identity using distinctive tokens and unique capability signatures, matching active clauses while keeping excluded, quoted, deferred, and delivery-only text out of capability selection.
Hardened routing prefilters candidates through the ContractIndex before composition. The composer orders the requested stages, then whole-route validation checks contract admissibility, dependencies, and typed input/output dataflow. Bounded repair can recompose or repair a broken route instead of silently accepting an invalid chain.
This is deterministic routing, not an LLM call. Scores are relative rankings, not probability estimates. Contract filtering, whole-route validation, and typed dataflow repair improve selection safety; a proposed route still never grants permission or executes a job.
Catalog search on this static site is keyword filtering. Custom semantic composition runs in your connected server. The example is real, precomputed parser output and is labelled separately from a live response.
Read the orchestration skill ↗ · Set up REST or MCP ↗Using Codex? Install the private plugin included with SolKraft. It lets Codex find useful skills, read their instructions, and use them while helping with your work. Install it directly from our GitHub repository using the steps below. You do not need Render, a hosted API, or a SolKraft API key.
python -m pip install "git+https://github.com/halthinks/SolKraft.git"
codex plugin marketplace add halthinks/SolKraft --sparse .agents/plugins --sparse plugins/solkraft
codex plugin add solkraft@solkraftYou need Python 3.11 or newer, Git, and Codex with plugin support. Run these commands in your terminal. The first installs the skill library; the next two add our GitHub repository to Codex and install its private plugin. Start Codex from the same terminal, then open a new chat. Do not search the public plugin directory for SolKraft.
Installation and troubleshooting ↗Host SolKraft on Render when you want another app or agent to connect to SolKraft over the internet. The included Codex plugin runs locally and does not need this.
Direct ChatGPT connection has not been tested. To use a skill in ChatGPT, open it in Explore, copy its instructions, and paste them into your chat.
Show me the hosting stepsThe agent searches or routes the request, retrieves useful procedures, then edits and tests with its existing tools. For a release gate, pass that context so “draft PR” routes to software testing.
This page is an explorer and setup console. It does not run your repository or claim to have fixed anything.
Download the plugin ZIP ↓skills.sh focuses on discovering and installing skills. Superpowers supplies an opinionated development methodology and agent workflows. SolKraft combines a multi-domain catalog, deterministic compound-request routing, inspectable relationships, and selective retrieval through REST and MCP. These approaches can coexist; there is no measured claim here that SolKraft beats either project.
Explore the steps, watch the signal move, and copy the settings you need. These are illustrated instructions; only the console’s Connect button makes a real API connection.
The included plugin is the easiest way to use SolKraft in Codex. The API and MCP let other software use the same skill library. The plugin already uses MCP behind the scenes.
The plugin sets up SolKraft’s tools and tells Codex when they are useful. Codex can find skills, read their instructions, and apply them while working on your task.
Install the Python package and plugin on your computer. You do not need Render or a SolKraft API key.
Show me the plugin stepsMCP is a standard way for an AI agent to discover and call tools. SolKraft’s tools let the agent search for skills, choose useful procedures, and retrieve their instructions.
The local Codex plugin sets this connection up for you. Other agents need their own MCP setup. To connect to a SolKraft server over the internet, give your agent the server’s HTTPS /mcp/ address and private API key.
Show me the agent connection stepsThe API lets your website, app, or script ask SolKraft for skills through ordinary web requests. You can build a skill browser, retrieve instructions, or send a task to /v1/route to get suggested skills.
This website uses the API when you connect a server and compose a route for your own request.
Show me the API stepsRender hosts your SolKraft server so apps and agents on other computers can connect over the internet. That one service provides both the API and remote MCP connection.
Choose this when another app or agent needs to connect over the internet. The local Codex plugin runs without it.
Show me the hosting stepsSay: “Find this bug, fix it, and test the result.” With the plugin installed, Codex can ask SolKraft for investigation, implementation, and testing skills through MCP. SolKraft returns the instructions. Codex reads them, edits your project, runs tests, and explains the result.
SolKraft supplies the methods. Your agent does the work. You do not need to set up the plugin, API, and MCP separately. For local Codex use, install the included plugin and its required Python package.
The bundled catalog loads automatically. An API connection is optional.
Compose a custom request right here, or load the worked example. Select a suggested skill to read and copy its procedure.
No API connection needed. The first route loads the local Python engine; following routes reuse it.
Loading graph…
Search compact descriptions first. Pull the full instructions only when a skill earns its place in the workflow.
Read the agent guide ↗One catalog serves a clean API and seven read-only MCP tools, including contract metadata and index inspection. Routing never grants execution authority.
Connect your client ↗Bring a skill, a bug report, or a better idea for how agents find their tools.
Get support ↗Give your agent the update guide. It covers the runtime, bundled skills, plugin refresh, and connection checks.
solkraft / agent-update.md ↗Use with the agent that manages your installation.
Update my SolKraft installation using https://halthinks.github.io/SolKraft/agent-update.md . Inspect the installed source first, preserve local changes and configuration, update the runtime and bundled skills plus the native plugin where installed, then verify actual MCP tool calls. Report what updated and anything still requiring a restart.
Architecture, routing repairs, and the evidence behind the results.