Foxl Docs

Skills

Extend Foxl with 69 installable skills for messaging, productivity, media, and more

Skills are installable capability packages that extend what Foxl can do. Each skill is a SKILL.md file containing instructions, tool requirements, and domain expertise that the agent loads on demand.

How Skills Work

Skills use a lazy-loading pattern for efficiency:

  1. Only skill names and short descriptions are included in the system prompt
  2. When the agent decides a skill is relevant, it reads the full SKILL.md file
  3. The skill's instructions guide the agent through the task

This keeps the agent fast while providing deep expertise when needed.

Skill Categories

Communication (6 skills)

SkillDescription
discordControl Discord bots, send messages, manage channels
slackSend and read Slack messages
imsgSend iMessages on macOS
wacliWhatsApp messaging via CLI
birdPost to Twitter/X
voice-callMake voice calls

Productivity (9 skills)

SkillDescription
githubManage PRs, issues, repositories
notionCreate and edit Notion pages
obsidianManage Obsidian vault notes
trelloManage Trello boards and cards
things-macThings 3 to-do management (macOS)
bear-notesBear note-taking app
apple-notesApple Notes integration
apple-notes-nativeNative Apple Notes via AppleScript
apple-remindersApple Reminders management

Media (9 skills)

SkillDescription
spotify-playerControl Spotify playback
spotifySpotify search and playlist management
sonosControl Sonos speakers
openhuePhilips Hue smart lighting
whisperLocal speech-to-text (Whisper)
whisper-apiOpenAI Whisper API transcription
sagScreen audio grab
songseeSong recognition
openai-image-genGenerate images with DALL-E

Development (5 skills)

SkillDescription
coding-agentCode writing and review sub-agent
tmuxTerminal multiplexer session management
mcporterMCP server porting utility
oracleOracle database queries
geminiGoogle Gemini API integration

Automation and Utility (14 skills)

SkillDescription
peekabooScreen capture
camsnapCamera snapshot
healthcheckService health monitoring
weatherWeather forecasts
goplacesPlace search and directions
gifgrepGIF search
himalayaEmail CLI client
1password1Password secret access
blucliBluetooth device management
food-orderFood ordering
blogwatcherBlog/RSS monitoring
morning-briefingDaily morning briefing automation
research-assistantWeb research automation
code-reviewAutomated code review

Browsing and Installing Skills

Open the Skills page from the sidebar to see all available skills. Each skill shows:

  • Name and description
  • Required tools or binaries
  • Platform compatibility
  • Activation status

Some skills require external tools. For example, the whisper skill needs the Whisper binary installed, and wacli needs the WhatsApp CLI tool. The Skills page shows compatibility status for each skill.

Creating Custom Skills

Create your own skill by adding a SKILL.md file:

~/.foxl/skills/my-skill/SKILL.md

The file uses YAML frontmatter for metadata and markdown for instructions:

---
name: my-skill
description: Short description of what this skill does
tools: [exec, web_fetch]
platforms: [macos, linux]
---

## Instructions

Tell the agent how to use this skill...

The agent will discover your skill automatically on next conversation.

On this page