# Static Agent Marketplace

A profile for publishing agent plugins and skills from a static website. It composes AI Catalog, Agent Skills discovery, the Claude Code marketplace format and llms.txt, and fills the gaps between them: where the remaining files live, one normalized catalog, reproducible archives, immutable versions, discovery links in HTML and install prompts.

Status: **0.1.0-draft**, an editor's draft. Expect changes before 1.0.0.

## Read

- [Editor's draft](spec/draft/)
- [JSON Schemas](schemas/)
- [Conformance suite](https://github.com/static-agent-marketplace/static-agent-marketplace-spec/tree/main/conformance)

## What a conforming site publishes

| Path | For |
|---|---|
| `/.well-known/ai-catalog.json` | AI Catalog readers |
| `/.well-known/agent-skills/index.json` | Agent Skills discovery clients |
| `/.claude-plugin/marketplace.json` | Claude Code, by URL |
| `/llms.txt` | language models |
| `/.agent-marketplace/` | the catalog, entries, archives and digests |

## Implementations

- [jekyll-theme-modootoday](https://github.com/modootoday/jekyll-theme-modootoday), the reference implementation, a Jekyll theme for GitHub Pages.

## Take part

Questions, bugs and proposals go to the [issue tracker](https://github.com/static-agent-marketplace/static-agent-marketplace-spec/issues). See [how to contribute](https://github.com/static-agent-marketplace/static-agent-marketplace-spec/blob/main/CONTRIBUTING.md).

The specification, schemas, tools and conformance suite are released under the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).