sanjay3290/ai-skills

outline

Search, read, and manage Outline wiki documents.

First seen Jan 21, 2026

Installation

$ npx skills add sanjay3290/ai-skills --skill outline

Summary

  • 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).

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from sanjay3290/ai-skills · top by installs.

npx skills add sanjay3290/ai-skills

Browse all from sanjay3290/ai-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 418
License LICENSE
Default branch main
Open issues 1
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version1.0
LicenseApache-2.0
More metadata
author
sanjay3290
version
1.0

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 4,556 B
  • docs README.md 6,200 B
  • docs SUMMARY.md 324 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 359 installs

SKILL.md

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

  1. Configure the environment:

``bash cp .env.example .env # Edit .env with your API key ``

  1. Set the environment variables:

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

Usage

Search documents

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

python3 scripts/outline.py read <document-id>
python3 scripts/outline.py read <document-id> --json

List collections

python3 scripts/outline.py list-collections
python3 scripts/outline.py list-collections --limit 50

List documents in a collection

python3 scripts/outline.py list-documents --collection-id <id>

Get collection details

python3 scripts/outline.py get-collection <collection-id>

Create a document

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

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

python3 scripts/outline.py export <document-id>
python3 scripts/outline.py export <document-id> --output doc.md

Test authentication

python3 scripts/outline.py auth-info

JSON Output

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

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

Operations Reference

Command Description Required Args
search Full-text search query
read Get document content document_id
list-collections List all collections -
list-documents List docs (optionally in collection) -
get-collection Get collection details collection_id
create Create new document --title, --collection-id
update Update existing document document_id
export Export as markdown document_id
auth-info Test API connection -

Environment Variables

Variable Required Default Description
OUTLINEAPIKEY Yes - Your Outline API token
OUTLINEAPIURL No https://app.getoutline.com/api API URL
OUTLINE_TIMEOUT No 30 Request timeout (seconds)
OUTLINEVERIFYSSL No true Set to false to skip SSL verification (for self-hosted instances with self-signed certs)

Troubleshooting

Error Solution
API key not configured Set OUTLINEAPIKEY environment variable
Authentication failed Verify API key is valid and not expired
Connection timeout Check OUTLINEAPIURL and network connectivity
SSL certificate error Set OUTLINEVERIFYSSL=false for self-signed certs
Document not found Verify document ID is correct
Permission denied Check 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