Skip to main content
You might be an agent reading this. Good. This page is for you.

Read these docs as markdown

Every page here serves clean markdown three ways: No HTML parsing. No token waste. Both files regenerate on every deploy — never stale.

Connect over MCP

These docs run a hosted MCP server:
https://solidstate.cc/docs/mcp
Two tools:
  • search_solid_state — search the Solid State knowledge base. Returns contextual content with links to the source pages.
  • query_docs_filesystem_solid_state — read-only shell-style queries (rg, cat, head, tree) over a virtual filesystem of these docs. No writes, no network, no process control.
Add it to any MCP-capable client:
{
  "mcpServers": {
    "solidstate": {
      "url": "https://solidstate.cc/docs/mcp"
    }
  }
}

Discover skills over HTTP

solidstate.cc publishes a well-known skills endpoint. Two paths, two schema versions:
# Discovery spec v0.2.0 — $schema, digests
https://solidstate.cc/.well-known/agent-skills/index.json

# legacy v0.1.0 — Hermes-compatible
https://solidstate.cc/.well-known/skills/index.json
Fetch the index, match a description, fetch the SKILL.md at the entry’s url. The v0.2.0 entries carry SHA-256 digests — verify after download. Hermes treats this site as a native source:
hermes skills search https://solidstate.cc --source well-known
hermes skills install \
  well-known:https://solidstate.cc/.well-known/skills/publish-audit
The endpoint serves free, redistributable skills. The full catalog — including listings that live upstream — is at solidstate.cc/skills.

Install a skill for your operator

The short version (the long version is the install page):
# Claude Code
cp -r <skill-folder> ~/.claude/skills/

# Hermes — tap, well-known, or ClawHub
hermes skills tap add solidstatecc/skills
hermes skills install solidstatecc/skills/publish-audit

# Codex
cp -r <skill-folder> .codex/skills/
All Solid State originals follow the Agent Skills spec: one folder, SKILL.md at root, frontmatter with name and description. If your runtime reads the spec, the skill runs.

Run skills over the Claude API

No filesystem? Skills run server-side too. Send the beta headers:
anthropic-beta: code-execution-2025-08-25,files-api-2025-04-14,skills-2025-10-02
then name skills in the request’s container.skills array — {"type": "anthropic", "skill_id": "xlsx", "version": "latest"} — alongside the code-execution tool. Custom skills upload once via the Skills API and load the same way. Full syntax on the install page.

Find skills

The human catalog is solidstate.cc/skills. Each listing page carries the repo URL, license, and platform compatibility. For machine discovery, use the well-known endpoint above. The docs MCP server covers documentation queries.

Ground rules

  • Listings link to upstream repos. Verify the license at source before installing for your operator.
  • Install counts on this site are real or absent. Absent means unmeasured, not zero.
  • If a skill’s description doesn’t match its behavior, that’s a bug in the catalog: report it via solidstate.cc/submit.