SPB Git

Repository Public MIT

index.md 3.0 KB 71 lines markdown

1---2title: Getting started3description: Find, inspect, verify and install an artifact in a few minutes, without an account.4order: 15section: Start6---78# Getting started910Skills is an open registry of reusable capabilities for AI agents: Agent Skills, MCP server listings, agent definitions, prompt packs, workflows and more. Reading, searching and downloading need no account.1112## 1. Find something1314Use the search box (press `/`), browse by type on [Explore](/explore), or call the API:1516```bash17curl -s "https://skills.spboucher.ai/api/v1/search?q=literature+review" | jq '.items[] | {name, type, summary, latestVersion}'18```1920## 2. Inspect it before you trust it2122Every artifact page shows the publisher, licence, declared permissions, the complete file list with a read-only viewer, scan findings, the release history and the SHA-256 of the archive. Read `SKILL.md` and any scripts. A skill is a set of instructions and files your agent will act on.2324Three signals appear on a page. They mean exactly this and nothing more:2526| Signal | Meaning |27|---|---|28| Identity verified | The registry operator confirmed who controls the publisher namespace. |29| Source verified | A moderator confirmed that the linked repository belongs to the publisher. |30| Scan status | Result of automated static checks. `passed` means no advisory findings; it does not mean safe. |3132More in [Security and trust](/docs/security).3334## 3. Download and verify3536```bash37curl -fsSLo hello-skill-1.0.0.tar.gz \38  https://skills.spboucher.ai/api/v1/artifacts/<namespace>/<slug>/versions/1.0.0/download39curl -fsS https://skills.spboucher.ai/api/v1/artifacts/<namespace>/<slug>/versions/1.0.0/checksum | shasum -a 256 -c -40tar -tzf hello-skill-1.0.0.tar.gz        # list the contents before extracting41```4243The checksum on the page, in the API and in the `X-Checksum-Sha256` response header is the hash of the bytes you receive. A published version never changes.4445## 4. Install4647Pick your client:4849- [Claude Code](/docs/install-claude-code)50- [OpenAI Codex](/docs/install-codex)51- [Cursor](/docs/install-cursor)52- [Any other Skills or MCP client](/docs/install-generic)5354With the Skills CLI, installing a skill is one command. It verifies the checksum, shows where files will go, and never runs anything from the package:5556```bash57skills install @<namespace>/<slug> --client claude-code58```5960The CLI is not yet published to npm. Until it is, run it from a checkout of the registry repository; see the [CLI reference](/docs/cli).6162## 5. Publish your own6364Publishing needs an account and a namespace, which the operator creates for you in this first version. See [Publishing your first artifact](/docs/publishing), or [Publishing from Claude Code](/docs/publishing-claude-code) if you want your agent to do the legwork under your approval.6566## Good to know6768- [Concepts](/docs/concepts): what a skill is, what an MCP server is, and why a listing is not a hosted service.69- [API](/docs/api), [MCP](/docs/mcp) and [CLI](/docs/cli) references.70- Found something harmful? Use the report link on the artifact page. No account needed.71
Files main
Menu

Theme