.dotfiles

Authoring AI instruction surfaces - SKILL.md, agent definitions, CLAUDE.md policies, and subagent briefs. Use when writing or editing any file that instructs an AI.

Interact with a live webpage inside a browser window — fill forms, click buttons, navigate authenticated apps, automate Electron apps, test web UI, capture browser-window screenshots for visual verification of web pages. Do NOT use for fetching or reading web content programmatically (use curl or MCP fetch). Do NOT use for desktop screenshots, system media/audio control, MPRIS players, or non-browser GUI — those belong to the desktop skill.

Drive herdr, the terminal workspace manager, and orchestrate Claude Code agents in it: spawn, prompt, read, wait on, or take over a background Claude. Also scripts herdr workspaces, tabs, and panes.

Code review, compliance checking, documentation standards, instruction-file audits, and output compression. Use when reviewing code, checking conventions, writing docs, auditing skill or CLAUDE.md edits, or when output needs to be more concise.

Manage the chise media stack: create and manage Jellyfin friend accounts, and check Jellyseerr request and download status. Use for friends, media requests, or Jellyfin users.

Log into and scrape data from Lucas's B3 Área do Investidor (investidor.b3.com.br) via the PinchTab browser-automation CLI plus raw CDP XHR capture. Use when syncing portfolio positions, trades, dividends, or any other read-only data from B3 — for example when Golden runs b3-sync, or when verifying brokerage state. Documents the working flow, the SPA quirks that broke prior attempts, the API endpoint catalog, and the institution-CNPJ filter trick.

Nix everything — language expertise (lazy eval, derivations, overlays, module system, flakes, agenix, cachix), applying config via rebuild, devenv project shells, THIS dotfiles repo conventions (module layout, isNixOS, script packaging, secrets, channels), and Docker/Podman container management via the docker-manager script. Use for any .nix edit, rebuild, devenv shell, container lifecycle, or "where does this belong in the dotfiles" question.

Master index and discovery entry point for Lucas's personal skills and channels. Run the listing script to enumerate every personal skill and chapter on demand. Use when work touches a personal tool or platform, or the user names a topic this index covers.

Control the VTuber avatar — start and stop the renderer, virtual camera, and virtual mic; speak through the avatar with lip sync; respond to voice conversation when hey-bot is active.

Capture and manage Lucas's tasks in his Todoist list via the `todo` CLI: add, list, complete, reschedule, digest. Use when recording a reminder or follow-up, or checking what is pending.

Git operations — creating high-quality conventional commits with meaningful messages and disciplined staging, and searching commit history efficiently via cached log dumps. Use when committing, staging changes, writing commit messages, investigating past decisions, finding when code changed, or tracing feature evolution through the repo's history.

Manage today's daily manager report file. Use when the user asks to generate, update, or finalize their standup or manager update, or when a meaningful unit of work should be logged into today's report.

Send Google Chat messages and webhooks, read history, resolve contacts by name. Browser-based automation via pinchtab.

Scrape X/Twitter posts, profiles, search results, followers, and trends. Use when user shares x.com or twitter.com URLs, asks to find tweets, check Twitter/X profiles, search X, monitor accounts, post tweets, or extract Twitter data.

Persist task context to disk so big or compaction-prone work survives across sessions. Use for work over ~5 steps, spanning sessions, or when explicitly asked to preserve context; not for quick fixes.

Drive a large software goal end-to-end - investigate context, design the build process, author a goal prompt, then execute with workflows and subagents until it works live. For big objectives needing a process, not one-off tasks.

End the current Claude Code session cleanly. Use when all work is complete and committed and the session should terminate.

Notify the user that work finished, by voice and desktop popup or mobile push. Use after substantial work; skip for quick answers and back-and-forth chat.

Restart the current Claude Code session in place, resuming the same session with an optional continuation prompt. Use to reload after config changes or resume work without waiting for input.

Switch the Bash working directory to another repo or directory for the session. Use when work must run commands outside the primary repo.

Create and work inside git worktrees for isolated parallel branches and PR workflows. Use when work needs an isolated branch without disturbing the main checkout.

De-slop human-facing prose: strip AI-writing tells and phrase per channel (commit, MR, ticket, doc, chat). Use when writing or editing text a human reads.

Recurring housekeeping sweep of the dotfiles tree for standing rot nothing else catches: stale markers, dead code, orphaned files, instruction drift, convention debt, chronic infra traps, test gaps. Triggers the dotfiles-housekeeping workflow.

Author a goal prompt for an autonomous or scheduled agent - a single-line plaintext brief under 3.5k chars. Use when writing the prompt that drives a routine, cron agent, remote trigger, or any one-field autonomous run.

On-demand research digest for any topic passed at invoke time; fans out across GitHub, arXiv, HN, Reddit, Lobste.rs and X, then dedups and ranks into a themed pulse. Use for "research digest", "catch me up on <topic>", or a curated AI/dev community pulse.

Desktop automation and media control — type text, send key combos, click/move/scroll/drag mouse, capture screenshots, read/write clipboard, music and audio playback (pause, play, next, previous, volume). Cross-platform for screenshots, clipboard, and media control (Linux/Wayland + macOS); keyboard and mouse remain Linux/Wayland-only. Use for any non-browser GUI interaction, any request to pause/play music, adjust volume, or control local media. For YouTube CLI, see the youtube skill.

Search code across GitLab repositories using Sourcebot. Use when searching for code patterns, functions, classes, APIs, or files across configured work repositories, or when managing the Sourcebot service.

Manage Jira issues, sprints, epics, and boards via jira-cli. Use when user asks to create issues, check sprint status, move tickets, log work, or interact with Jira.

Manage the Obsidian vault (daily notes, TODO tracking, activity logging, and inbox processing). Use when user mentions daily note, wants to log activity, add/check TODOs, review pending tasks, plan their day, process saved items, or interact with the vault.

Golden's 08:00 routine — resume HEARTBEAT.md or run the market briefing (US/BR markets, FX, portfolio quotes, headlines, geopolitics), save to briefings/<date>.md, and ship the FULL report to Lucas via Discord MCP reply. Heartbeat-only.

Search YouTube and manage playlists from the CLI — agent-optimized youtube-cli with JSON output. Search via yt-dlp (no auth). Playlist management via YouTube Data API v3 (OAuth2).

Implement, debug, and test Quickshell bar/OSD/switcher. Use when modifying QML files, debugging shape paths or rendering, testing IPC calls, or verifying visual changes after edits. Also use when adding new bar modules, popouts, dashboard tabs, or launcher features.

Testing methodology and verification workflow. Use when implementing, fixing, or modifying any code. Defines the test-first, test-after, and pre-delivery verification protocol.

Current-information research and synthesis for tools, vendors, standards, or decisions. Use when the user asks to research, compare, evaluate, verify, or find the latest external information; not for local repo search.