Agent skill

Outline

by sanjay3290 in sanjay3290/ai-skills

Search, read, and manage Outline wiki documents. An agent skill from sanjay3290/ai-skills.

Apache-2.0Auto-check: notesKnowledge Management

Install Outline

skills CLI
$ npx skills add sanjay3290/ai-skills --skill outline -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install sanjay3290/ai-skills outline --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/sanjay3290/ai-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/outline .claude/skills/outline && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
outline
GitHub stars
431
Token cost
~1.1k tokens
SKILL.md length
292 words
Files
6 (incl. scripts)
Skills in repo
24
Repo updated
First seen
Licence
Apache-2.0

At a glance

Search, read, and manage Outline wiki documents. An agent skill from sanjay3290/ai-skills.

  • Works in 3 steps: Get your API key from your Outline wiki → Configure the environment → Set the environment variables
  • Searching wiki for documentation
  • SKILL.md covers Requirements, Setup, Usage and JSON Output, plus 5 more sections
  • Runs Python scripts from its folder; calls python3 and pip; needs OUTLINE_API_KEY

What it does

Outline is an agent skill from sanjay3290/ai-skills. Search, read, and manage Outline wiki documents. Use when: (1) searching wiki for documentation, (2) reading wiki pages or articles, (3) listing wiki collections or documents, (4) creating or updating wiki content, (5) exporting documents as markdown. Works with any Outline wiki instance (self-hosted or cloud).

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts (for example `README.md` and `scripts/outline.py`).

It sits in Knowledge Management, covering Markdown. The repository describes itself as: 24 cross-platform agent skills for Claude Code, Cursor, Codex & Gemini CLI — databases, messaging, research, TTS, DevOps, and Google Workspace. The licence is Apache-2.0.

When your agent uses it

  • Searching wiki for documentation
  • Reading wiki pages
  • Listing wiki collections
  • Updating wiki content

Example prompts

  • “/outline”

Requirements

  • Python 3
  • A credential in OUTLINE_API_KEY

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Get your API key from your Outline wiki
  2. Configure the environment
  3. Set the environment variables

What it can do on your machine

Read from SKILL.md and the folder at commit 281d88d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • pip

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • OUTLINE_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Outline loads about 1.1k tokens when it runs. Until then it costs about 80 tokens; SKILL.md has 292 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~80
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:27
    cp .env.example .env
  • NoteMentions a .env fileSKILL.md:28
    # Edit .env with your API key

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from sanjay3290/ai-skills at commit 281d88d, republished under its Apache-2.0 licence (© sanjay3290). 292 words, ~1,139 tokens.

Download SKILL.mdSave it as .claude/skills/outline/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
outline
description
Search, read, and manage Outline wiki documents. Use when: (1) searching wiki for documentation, (2) reading wiki pages or articles, (3) listing wiki collections or documents, (4) creating or updating wiki content, (5) exporting documents as markdown. Works with any Outline wiki instance (self-hosted or cloud).
license
Apache-2.0
metadata.author
sanjay3290
metadata.version
1.0

Outline Wiki Skill

Search, read, create, and manage documents in any Outline wiki instance. Works with all AI clients supporting the Agent Skills Standard.

Requirements

  • Python 3.8+
  • Dependencies: pip install -r requirements.txt

Setup

  1. Get your API key from your Outline wiki:

    • Go to Settings > API Tokens
    • Create a new token with appropriate permissions
  2. Configure the environment:

    bash
    cp .env.example .env
    # Edit .env with your API key
  3. Set the environment variables:

    bash
    export OUTLINE_API_KEY=your-api-key-here
    # Optional: for self-hosted instances
    export OUTLINE_API_URL=https://your-wiki.example.com/api

Usage

Search documents
bash
python3 scripts/outline.py search "deployment guide"
python3 scripts/outline.py search "API documentation" --limit 10
python3 scripts/outline.py search "onboarding" --collection-id <id>
Read a document
bash
python3 scripts/outline.py read <document-id>
python3 scripts/outline.py read <document-id> --json
List collections
bash
python3 scripts/outline.py list-collections
python3 scripts/outline.py list-collections --limit 50
List documents in a collection
bash
python3 scripts/outline.py list-documents --collection-id <id>
Get collection details
bash
python3 scripts/outline.py get-collection <collection-id>
Create a document
bash
python3 scripts/outline.py create --title "New Guide" --collection-id <id>
python3 scripts/outline.py create --title "Guide" --collection-id <id> --text "# Content here"
python3 scripts/outline.py create --title "Draft" --collection-id <id> --draft
Update a document
bash
python3 scripts/outline.py update <document-id> --title "Updated Title"
python3 scripts/outline.py update <document-id> --text "New content"
python3 scripts/outline.py update <document-id> --publish
Export document as markdown
bash
python3 scripts/outline.py export <document-id>
python3 scripts/outline.py export <document-id> --output doc.md
Test authentication
bash
python3 scripts/outline.py auth-info

JSON Output

Add --json flag to any command for machine-readable output:

bash
python3 scripts/outline.py search "query" --json
python3 scripts/outline.py read <id> --json

Operations Reference

CommandDescriptionRequired Args
searchFull-text searchquery
readGet document contentdocument_id
list-collectionsList all collections-
list-documentsList docs (optionally in collection)-
get-collectionGet collection detailscollection_id
createCreate new document--title, --collection-id
updateUpdate existing documentdocument_id
exportExport as markdowndocument_id
auth-infoTest API connection-

Environment Variables

VariableRequiredDefaultDescription
OUTLINE_API_KEYYes-Your Outline API token
OUTLINE_API_URLNohttps://app.getoutline.com/apiAPI URL
OUTLINE_TIMEOUTNo30Request timeout (seconds)
OUTLINE_VERIFY_SSLNotrueSet to false to skip SSL verification (for self-hosted instances with self-signed certs)

Troubleshooting

ErrorSolution
API key not configuredSet OUTLINE_API_KEY environment variable
Authentication failedVerify API key is valid and not expired
Connection timeoutCheck OUTLINE_API_URL and network connectivity
SSL certificate errorSet OUTLINE_VERIFY_SSL=false for self-signed certs
Document not foundVerify document ID is correct
Permission deniedCheck API token has required permissions

Exit Codes

  • 0: Success
  • 1: Error (auth failed, not found, invalid request)

Workflow

  1. Run auth-info to verify connection
  2. Run list-collections to see available collections
  3. Run search or list-documents to find content
  4. Run read to get full document content
  5. Use create/update to modify wiki content

© sanjay3290, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (scripts) in skills/outline of sanjay3290/ai-skills.

  • SKILL.md
  • .env.example
  • .gitignore
  • README.md
  • requirements.txt
  • scripts/outline.py

Open the folder on GitHubat commit 281d88d

Compare with similar skills

Outline next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Outline compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Outline this skillsanjay3290/ai-skills431—~1.1kAutomated safety check: NotesApache-2.0
Open Knowledge Discoveryinkeep/open-knowledge4.4k—~2kAutomated safety check: PassGPL-3.0
Wordgardbangle-io/bangle-io1.2k—~1.5kAutomated safety check: PassAGPL-3.0
Interlinked Markdown Wikiholon-run/holon154—~1.6kAutomated safety check: PassApache-2.0
Confluence To Markdowniurykrieger/claude-bedrock1051 repos~2.8kAutomated safety check: NotesMIT
Baoyu URL To Markdownsdyckjq-lab/llm-wiki-skill2.5k2 repos~3.2kAutomated safety check: PassNone

Similar skills

  • Open Knowledge Discovery

    inkeep/open-knowledge

    Read when the user asks what OpenKnowledge is, wants to install it on a repository, wants to open or preview a single markdown file that is not part of an OpenKnowledge project, wants to share an…

    4.4k GitHub stars~2k tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Wordgard

    bangle-io/bangle-io

    Write idiomatic Wordgard editor code (schema elements, extensions, commands, decorations, markdown specs) for the editor-w stack.

    1.2k GitHub stars~1.5k tokensUpdated 4 days ago
    Knowledge ManagementAuto-check passed
  • Maintain a file-first, auditable Markdown knowledge base with stable pages, sources, wikilinks, backlinks, indexes, freshness, and reviewable health reports.

    154 GitHub stars~1.6k tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Confluence To Markdown

    iurykrieger/claude-bedrock

    Internal fetcher module for Confluence pages. An agent skill from iurykrieger/claude-bedrock.

    105 GitHub starsUsed in 1 repo~2.8k tokens
    Knowledge ManagementAuto-check: notes
  • Baoyu URL To Markdown

    sdyckjq-lab/llm-wiki-skill

    Fetch any URL and convert to markdown using Chrome CDP. An agent skill from sdyckjq-lab/llm-wiki-skill.

    2.5k GitHub starsUsed in 2 repos~3.2k tokens
    Knowledge ManagementAuto-check passed
  • X to Markdown Converter

    JimLiu/baoyu-skills

    Saves tweets, threads and X Articles as Markdown files with YAML front matter, using an unofficial API that asks for your consent first.

    26k GitHub starsUsed in 4 repos~1.8k tokens
    Knowledge ManagementAuto-check: warnings

More from sanjay3290/ai-skills

All 24 skills in this repo
  • Deep Research

    sanjay3290/ai-skills

    Execute autonomous multi-step research using Google Gemini Deep Research Agent.

    431 GitHub starsUsed in 9 repos~683 tokens
    Auto-check: notes
  • Imagen

    sanjay3290/ai-skills

    Generate images using Google Gemini's image generation capabilities.

    431 GitHub starsUsed in 6 repos~657 tokens
    Auto-check passed
  • Notebooklm

    sanjay3290/ai-skills

    Query and manage Google NotebookLM notebooks with persistent profile auth, source sync, batch/multi queries, and structured exports.

    431 GitHub stars~655 tokensUpdated 28 days ago
    Auto-check passed
  • Whatsapp

    sanjay3290/ai-skills

    Send and receive WhatsApp messages via the unofficial linked-device client pywhats (pip install pywhats) — pair with QR, send text/images, group chat, read receipts, presence/typing, and a…

    431 GitHub stars~1.1k tokensUpdated 28 days ago
    Auto-check passed
  • Postgres

    sanjay3290/ai-skills

    Execute read-only SQL queries against multiple PostgreSQL databases.

    431 GitHub starsUsed in 1 repo~975 tokens
    Auto-check passed
  • Atlassian

    sanjay3290/ai-skills

    Manage Jira issues and Confluence wiki pages in Atlassian Cloud.

    431 GitHub stars~1.6k tokensUpdated 28 days ago
    Auto-check passed

Questions about Outline

What does Outline do?

Search, read, and manage Outline wiki documents. An agent skill from sanjay3290/ai-skills. Outline is an agent skill from sanjay3290/ai-skills. Search, read, and manage Outline wiki documents.

When should I use Outline?

Outline fits situations like: searching wiki for documentation; reading wiki pages; listing wiki collections; updating wiki content.

How do I install Outline in Claude Code?

Run `npx skills add sanjay3290/ai-skills --skill outline -a claude-code`. Or copy the skill folder (skills/outline in sanjay3290/ai-skills) into .claude/skills/outline in your project. Claude Code loads it when a task matches its description.

How do I install Outline in Codex?

Run `npx skills add sanjay3290/ai-skills --skill outline -a codex`. Or copy the skill folder (skills/outline in sanjay3290/ai-skills) into .agents/skills/outline in your project. Codex loads it when a task matches its description.

Can I use Outline in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sanjay3290/ai-skills --skill outline -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/outline, .gemini/skills/outline, .github/skills/outline and .opencode/skills/outline in your project.

What does Outline need to run?

Going by SKILL.md and its folder, Outline needs Python for the scripts in its folder, the command-line tools its instructions call (python3 and pip) and credentials named OUTLINE_API_KEY. Our summary lists: Python 3; A credential in OUTLINE_API_KEY.

Does Outline access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Outline safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Outline use?

Outline is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Outline use?

About 1.1k tokens (SKILL.md is roughly 4.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Outline?

Skills that share tags, products or a category with Outline: Open Knowledge Discovery (inkeep/open-knowledge, 4.4k stars), Wordgard (bangle-io/bangle-io, 1.2k stars), Interlinked Markdown Wiki (holon-run/holon, 154 stars) and Confluence To Markdown (iurykrieger/claude-bedrock, 105 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Outline?

sanjay3290 (a GitHub user) maintains it in sanjay3290/ai-skills, which has 431 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on September 10, 2026.

Source: sanjay3290/ai-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.