Skip to content
Developers
GuidesAPI reference
slimwiki.comGet an API key

Guides

  • Quickstart
  • Authentication
  • Errors
  • Pagination
  • Rate limits
  • Content format
  • Versioning

Tools and agents

  • CLI
  • MCP server
  • Agent skill

API reference

  • Overview

Users

  • Retrieve the key ownerget

Accounts

  • List accountsget

Wikis

  • List wikisget
  • Retrieve a wikiget

Pages

  • List pages in a wikiget
  • Search pages in a wikiget
  • Find a page by slug or hashget
  • Create a pagepost
  • Retrieve a pageget
  • Delete a pagedelete
  • Archive a pagepost
  • Restore a pagepost

Guides

Agent skill

The SlimWiki skill is a single instructions file. Give it to an agent that supports skills and it knows how to find, read and create pages in your wikis.

On this page

  • What the skill does
  • Install
  • Give the agent a connection
  • Try it

What the skill does

A skill is a file named SKILL.md that an agent loads when a task calls for it. The SlimWiki skill tells the agent:

  • how accounts, wikis and pages fit together, and how to find a page;
  • which actions exist, and which do not (it cannot edit an existing page);
  • how to write page content in SlimWiki's node format;
  • what each error means and when to stop and ask you.

The skill does not connect to SlimWiki by itself. It uses whichever connection the agent has, in this order: the MCP server, the CLI, or the API with a key in the SLIMWIKI_API_KEY environment variable.

Install

Download the file into your agent's skills folder. For Claude Code, a skill available in every project lives under ~/.claude/skills:

Install for Claude Code
mkdir -p ~/.claude/skills/slimwiki
curl -fsSL https://developers.slimwiki.com/skills/slimwiki/SKILL.md \
  -o ~/.claude/skills/slimwiki/SKILL.md

To share it with everyone working in a repository, put it in .claude/skills/slimwiki/SKILL.md inside the repository instead. For other agents, place the file where that agent reads skills or project instructions from.

You can also open the skill file and read it first: it is plain text.

Give the agent a connection

Set up one of these so the skill has something to work with:

  • MCP server: nothing to install; add the server to your agent. See MCP server.
  • CLI: install it and run slimwiki auth login. See CLI.
  • API key: create a key and set it as SLIMWIKI_API_KEY in the environment the agent runs in. See Authentication.

Do not paste a key into the conversation

Put the key in an environment variable or your agent's MCP configuration. The skill tells the agent not to ask for one in chat.

Try it

Ask your agent something that needs your wiki, for example:

Example requests
Find our release checklist in SlimWiki and summarise it.
Create a SlimWiki page called "Retro notes" with these three points: …

The agent acts as you, with the access of the key or sign-in it uses. Give it a read-only key if it should only look things up.

Previous

MCP server
Connect an AI assistant to SlimWiki with the Model Context Protocol.

Next

API reference
Every endpoint, with parameters, response fields and example requests.

SlimWiki Developers

slimwiki.com