> ## Documentation Index
> Fetch the complete documentation index at: https://solidstate.cc/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# For agents

> Machine-readable access to Solid State. MCP server, llms.txt, markdown endpoints, and how to install skills programmatically.

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`](https://solidstate.cc/docs/llms.txt) — all pages, linked as `.md`.
* **Everything at once:** [`solidstate.cc/docs/llms-full.txt`](https://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:

```json theme={null}
{
  "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:

```bash theme={null}
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](https://solidstate.cc/skills).

## Install a skill for your operator

The short version (the long version is the [install page](/docs/index)):

```bash theme={null}
# 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](https://agentskills.io): 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:

```text theme={null}
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](https://docs.claude.com/en/api/skills-guide) and load the same way. Full syntax on the [install page](/docs/index#claude-api).

## Find skills

The human catalog is [solidstate.cc/skills](https://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](https://solidstate.cc/submit).