Agent skill

outline

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

View SKILL.md on GitHub Repository
Stars 184
Forks 18

Install this agent skill to your Project

npx add-skill https://github.com/sanjay3290/ai-skills/tree/main/skills/outline

Metadata

Additional technical details for this skill

author
sanjay3290
version
1.0

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

  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

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
OUTLINE_API_KEY Yes - Your Outline API token
OUTLINE_API_URL No https://app.getoutline.com/api API URL
OUTLINE_TIMEOUT No 30 Request timeout (seconds)

Troubleshooting

Error Solution
API key not configured Set OUTLINE_API_KEY environment variable
Authentication failed Verify API key is valid and not expired
Connection timeout Check OUTLINE_API_URL and network connectivity
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

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

sanjay3290/ai-skills

google-calendar

Interact with Google Calendar - list calendars, view events, create/update/delete events, and find free time. Use when user asks to: check calendar, schedule a meeting, create an event, find available time, list upcoming events, delete or update a calendar event, or respond to meeting invitations. Lightweight alternative to full Google Workspace MCP server with standalone OAuth authentication.

184 18
Explore
sanjay3290/ai-skills

azure-devops

Manage Azure DevOps projects, work items, repos, PRs, pipelines, wikis, test plans, security alerts, variable groups, environments/approvals, branch policies, and attachments. Use when user asks to: manage sprints, create/update work items, list repos, create PRs, run pipelines, search code, manage wiki pages, check security alerts, manage variable groups, approve deployments, or configure branch policies. Covers 13 domains with 99 tools via REST API.

184 18
Explore
sanjay3290/ai-skills

manus

Delegate complex, long-running tasks to Manus AI agent for autonomous execution. Use when user says 'use manus', 'delegate to manus', 'send to manus', 'have manus do', 'ask manus', 'check manus sessions', or when tasks require deep web research, market analysis, product comparisons, stock analysis, competitive research, document generation, data analysis, or multi-step workflows that benefit from autonomous agent execution with parallel processing.

184 18
Explore
sanjay3290/ai-skills

google-sheets

Read and write Google Sheets spreadsheets - get content, update cells, append rows, fetch specific ranges, search for spreadsheets, and view metadata. Use when user asks to: read a spreadsheet, update cells, add data to Google Sheets, find a spreadsheet, check sheet contents, export spreadsheet data, or get cell values. Lightweight integration with standalone OAuth authentication supporting full read/write access.

184 18
Explore
sanjay3290/ai-skills

google-drive

Interact with Google Drive - search files, find folders, list contents, download files, upload files, create folders, move, copy, rename, and trash files. Use when user asks to: search Google Drive, find a file/folder, list Drive contents, download or upload files, create folders, move files, or organize Drive content. Lightweight integration with standalone OAuth authentication supporting full read/write access.

184 18
Explore
sanjay3290/ai-skills

deep-research

Execute autonomous multi-step research using Google Gemini Deep Research Agent. Use for: market analysis, competitive landscaping, literature reviews, technical research, due diligence. Takes 2-10 minutes but produces detailed, cited reports. Costs $2-5 per task.

184 18
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results