AGENTS/skills/outline/SKILL.md

name, description, compatibility

name	description	compatibility
outline	Outline wiki integration for knowledge management and documentation workflows. Use when Opencode needs to interact with Outline for: (1) Creating and editing documents, (2) Searching and retrieving knowledge base content, (3) Managing document collections and hierarchies, (4) Handling document sharing and permissions, (5) Collaborative features like comments. Triggers: 'Outline', 'wiki', 'knowledge base', 'documentation', 'team docs', 'document in Outline', 'search Outline', 'Outline collection'.	opencode

Outline Wiki Integration

Outline is a team knowledge base and wiki platform. This skill provides guidance for Outline API operations and knowledge management workflows.

Core Capabilities

Document Operations

• Create: Create new documents with markdown content
• Read: Retrieve document content, metadata, and revisions
• Update: Edit existing documents, update titles and content
• Delete: Remove documents (with appropriate permissions)

Collection Management

• Organize: Structure documents in collections and nested collections
• Hierarchies: Create parent-child relationships
• Access Control: Set permissions at collection level

Search and Discovery

• Full-text search: Find documents by content
• Metadata filters: Search by collection, author, date
• Advanced queries: Combine multiple filters

Sharing and Permissions

• Public links: Generate shareable document URLs
• Team access: Manage member permissions
• Guest access: Control external sharing

Collaboration

• Comments: Add threaded discussions to documents
• Revisions: Track document history and changes
• Notifications: Stay updated on document activity

Workflows

Creating a New Document

1. Determine target collection
2. Create document with title and initial content
3. Set appropriate permissions
4. Share with relevant team members if needed

Searching Knowledge Base

1. Formulate search query
2. Apply relevant filters (collection, date, author)
3. Review search results
4. Retrieve full document content when needed

Organizing Documents

1. Review existing collection structure
2. Identify appropriate parent collection
3. Create or update documents in hierarchy
4. Update collection metadata if needed

Document Collaboration

1. Add comments for feedback or discussion
2. Track revision history for changes
3. Notify stakeholders when needed
4. Resolve comments when addressed

Integration Patterns

Knowledge Capture

When capturing information from conversations or research:

• Create document in appropriate collection
• Use clear, descriptive titles
• Structure content with headers for readability
• Add tags for discoverability

Documentation Updates

When updating existing documentation:

• Retrieve current document revision
• Make targeted, minimal changes
• Add comments explaining significant updates
• Share updates with relevant stakeholders

Knowledge Retrieval

When searching for information:

• Start with broad search terms
• Refine with collection and metadata filters
• Review multiple relevant documents
• Cross-reference linked documents for context

Common Use Cases

Use Case	Recommended Approach
Project documentation	Create collection per project, organize by phase
Team guidelines	Use dedicated collection, group by topic
Meeting notes	Create documents with templates, tag by team
Knowledge capture	Search before creating, link to related docs
Onboarding resources	Create structured collection with step-by-step guides

Best Practices

• Consistent naming: Use clear, descriptive titles
• Logical organization: Group related documents in collections
• Regular maintenance: Review and update outdated content
• Access control: Set appropriate permissions for sensitive content
• Searchability: Use tags and metadata effectively
• Collaboration: Use comments for discussions, not content changes

Handoff to Other Skills

Output	Next Skill	Trigger
Research findings	knowledge-management	"Organize this research in Outline"
Documentation draft	communications	"Share this document via email"
Task from document	task-management	"Create tasks from this outline"
Project plan	plan-writing	"Create project plan in Outline"