dotfiles

CLI tool for interacting with MCP (Model Context Protocol) servers. Use when invoking MCP tools, managing MCP servers, or working with MCP-based APIs. Triggers on "MCP server", "mcpli", "invoke MCP tool", or any MCP server interaction.

Use when executing a plan or implementing a coding task. Turns a plan or clear request into working code, tests, and verification.

Use for researching, checking facts, looking things online, comparing options, etc.

Use when asked to plan a coding task. Produces a written implementation plan (research plus steps) for a code change.

Use before performing a rebase or resolving rebase conflicts.

Use when opening a pull request, pushing changes for review, or when the user says "open PR", "create PR", "send for review", or "get this merged".

Reflect on the current conversation to find ways to improve agent skills and config. Use for "retro", "retrospective", "reflect on this conversation", "what could be improved", or "extract a skill from this".

Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD, mentions "red-green-refactor", wants integration tests, or asks for test-first development.

Use when writing or updating a changelog. Always load this skill before editing the changelog file. Triggers on "update the changelog", "add a changelog entry", "changelog", or editing CHANGELOG.md.

Guidance on writing high-quality skills and prompt templates. Use when creating, reviewing, or improving agent instructions. Triggers on "write a skill", "create a prompt template", "capture skill", "capture template", "review skills", "deprescribe", or any agent authoring task.

Use when refactoring into deep modules, choosing seams, classifying dependencies, deciding adapter strategy, or planning tests around a refactor.

Find deep-module opportunities in a codebase. Use when the user wants to improve architecture, refactor, consolidate tightly-coupled modules, or make a codebase more testable and AI-navigable.

Use when writing code plans, architecture, or generally discussing code

Pi documentation pointers. Use when the user asks about pi itself, its SDK, extensions, themes, skills, or TUI.

Patterns in vocabulary, structure, formatting, tone, and citations that are characteristic of LLM-generated text. Avoid these when writing any text.

Explore the design space of a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, explore design options, or mentions "grill me".

Use when working with GitHub notifications.

Use when writing, reviewing, or improving tests, deciding what to mock, or designing interfaces for testability.

Use when adding, installing, removing, or managing agent skills in this dotfiles repo. Triggers on "add skill", "install skill", "remove skill", "delete skill", "new skill", "manage skills", or any skill management task.

Send a message to another running pi session via its Unix socket. Use when the user wants to hand off context to another session, continue a conversation elsewhere, or notify another pi instance.

Discover and load agent skills from the SkillsMP marketplace. Use when the user asks "how do I do X", "find a skill for X", "is there a skill for X", "can you do X" where X is a specialized capability, or expresses interest in extending agent capabilities.

Control Chrome browser via CLI for testing, automation, and debugging. Use when the user needs browser automation, screenshots, form filling or page inspection.

Manage personal notes in an Obsidian vault at $NOTES_VAULT. Use when the user mentions notes, vault, knowledge base, or asks to find/create/read/edit notes. Triggers on daily notes, project tasks, personal information lookup, or any note-related request.

Find, list, and analyse pi agent sessions. Use when the user asks about past pi conversations, session history, costs, what pi did, reviewing a session, or debugging agent behaviour.

Manage local projects organized by owner/repo in $WORKSPACE. Use when cloning repos, inspecting dependencies, cross-referencing projects, listing local repositories, or reading/searching files from other local projects. Triggers on "clone repo", "check that project", "look at the source", "compare with other repo", any reference to other local projects, or any Git repository URL (e.g. "https://github.com/owner/repo", "git@github.com:owner/repo").

Download videos, extract audio, and get transcripts from YouTube and 1000+ sites. Use when asked to download a video, extract audio, get a transcript, rip subtitles, or fetch media. Triggers on "download video", "yt-dlp", "extract audio", "YouTube download", "get transcript", "subtitles", or any media download request.

Git commit workflow. Use when asked to commit changes or on the word `commit`.