Agent Skills

Agent Skills are modular capability packages that define how the agent (Clawd) interacts with external tools, APIs, and services. Each skill lives in commune/skills/<name>/ and contains a SKILL.md with instructions, patterns, and constraints.

How Skills Work

A skill is a folder with documentation that teaches the agent how to use a tool. Skills aren’t code libraries — they’re structured knowledge. The agent reads the SKILL.md at runtime and follows its instructions to accomplish tasks.

Skills may include:

• API patterns and endpoints
• CLI commands and flags
• Safety constraints and guardrails
• Example workflows

Skills by Category

🏠 Infrastructure & Smart Home

Skill	Description
homeassistant	Control Home Assistant — smart plugs, lights, scenes, automations via the HA REST API
static-deploy	Deploy built static sites to the self-hosted web server via SSH. See Static Site Hosting

🔐 Security

Skill	Description
bitwarden	Access and manage Bitwarden/Vaultwarden passwords securely using the rbw CLI. See Credential Management

📱 Social & Communication

Skill	Description
bluesky	Interact with Bluesky/AT Protocol — post, read timeline, check notifications, search, like, and delete posts
email	Send emails via SMTP. Send-only, single recipient, hardcoded sender

🎵 Media & Entertainment

Skill	Description
concert-radar	Cross-reference music taste (Last.fm + Plex) against Bay Area concert listings. See Concert Radar
tautulli	Monitor Plex activity and stats via Tautulli API — who’s watching, history, library stats
midjourney	Generate images using Midjourney via the midapi.ai API — text-to-image, upscaling, style profiles
yt-summarize	Summarize YouTube videos by extracting transcripts and captions via yt-dlp

📊 Data & Visualization

Skill	Description
dataviz	Generate charts, graphs, and data visualizations as images for diary entries, Discord, or docs
mermaid	Create diagrams using Mermaid syntax — flowcharts, sequence diagrams, architecture diagrams. Renders to PNG/SVG

🖼️ Image & Video

Skill	Description
imagemagick	Image manipulation operations — resize, crop, composite, annotate, format conversion
ffmpeg-video-editor	Generate FFmpeg commands from natural language — cut, trim, convert, compress, extract audio

📝 Knowledge & Writing

Skill	Description
obsidian	Read and search Brad’s Obsidian vault for context — the primary personal knowledge base
outline	Interact with Outline wiki — create, read, update, search, and organize documents

🎲 Games

Skill	Description
foundryvtt	Interact with FoundryVTT — roll dice, manage actors, run combat, search compendiums, control scenes

🌤️ Utilities

Skill	Description
weather	Get current weather and forecasts via wttr.in (no API key required)

🤖 Meta / Self-Improvement

Skill	Description
self-improving-agent	Capture learnings, errors, and corrections for continuous improvement. Review before major tasks
reflect	End-of-day reflection routine — self-care first, then community service

Adding a New Skill

1. Create a folder in commune/skills/<skill-name>/
2. Write a SKILL.md with: purpose, commands/patterns, constraints, examples
3. Optionally add metadata in YAML front matter (emoji, required bins, env vars)
4. Commit and push to the skills repo

The agent discovers skills automatically — no registration step needed.

See Also

• Credential Management — how skills access API keys and secrets securely
• Concert Radar — deep dive into one of the more complex skills
• Library Governance — how to contribute to the library (and by extension, skill documentation)
• Last.fm API — music data API used by concert-radar and morning-briefing skills
• The Practice — the daily routine that governs how skills are created, maintained, and documented