For agents - Solid State

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:

Index: solidstate.cc/docs/llms.txt — all pages, linked as .md.
Everything at once: solidstate.cc/docs/llms-full.txt — the full docs in one file.
Per page: append .md to any docs URL. Or send Accept: text/markdown and get markdown back.

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.

​Read these docs as markdown

​Connect over MCP

​Discover skills over HTTP

​Install a skill for your operator

​Run skills over the Claude API

​Find skills

​Ground rules