Updated today
by ooloth
dotfiles
My macOS development environment, including the agent skills and workflows I use for software engineering.
24 GitHub stars (24)
Steady at 24 stars — no new stars in the 16 days since Sep 30.
- 30 skills (30 skills found in its SKILL.md files)
- 3 forks (3 forks)
- Today last update (Last updated today)
Install
Skills CLI
npx skills add ooloth/dotfiles
Asks which skills and agents to install. Just one: npx skills add ooloth/dotfiles --skill add-tool — add -g for every project.
Claude Code
git clone https://github.com/ooloth/dotfilescp -r "dotfiles/.claude/skills/add-tool" ~/.claude/skills/
Copies the add-tool skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add ooloth/dotfiles
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md — showing the first 30 of 34 files.
-
add-tool
Add a new tool to the dotfiles repository. Use when asked to add a new CLI tool, application, or package as a managed dotfiles tool.
.claude/skills/add-tool/SKILL.md on GitHub (opens in a new tab) -
uphold-project-invariants
Load this repo's own invariants and standards (docs/invariants/, docs/standards/) and apply them to the current task. ALWAYS invoke before designing, writing, or editing ANY code.
.claude/skills/uphold-project-invariants/SKILL.md on GitHub (opens in a new tab) -
commit
Commit the changes in the working tree. Only invoke when the user explicitly signals to commit ("commit", "/commit", etc.). Never invoke this skill on your own initiative — implementation approval is not a commit signal.
tools/agents/config/skills/commit/SKILL.md on GitHub (opens in a new tab) -
create-pr
Draft a PR for the changes on the current branch using the "commit" and "write-pr-description" skills.
tools/agents/config/skills/create-pr/SKILL.md on GitHub (opens in a new tab) -
design
Design the type progression, assertion plan, telemetry plan and test plan for approved work. Invoke after agreeing on the high-level approach and before writing any implementation.
tools/agents/config/skills/design/SKILL.md on GitHub (opens in a new tab) -
discuss
Explore a task and validate the overall strategy before implementation. TRIGGER for ambiguous tasks, design discussions, multi-step work, risky changes, or when the user asks a question before implementation.
tools/agents/config/skills/discuss/SKILL.md on GitHub (opens in a new tab) -
handoff
Tell the next agent everything they need to know to continue your work.
tools/agents/config/skills/handoff/SKILL.md on GitHub (opens in a new tab) -
prove-it-works
Survey observable paths, run the real system, capture evidence, and surface gaps. TRIGGER when asked to prove a change works or write a QA plan.
tools/agents/config/skills/prove-it-works/SKILL.md on GitHub (opens in a new tab) -
review-code
Standalone code review for any scope — PR number, branch, file paths, or current changes. Synthesizes intent, runs 11 parallel specialized agents, and presents actionable findings with a verdict. For PR scope, optionally posts the review to GitHub with inline comments.
tools/agents/config/skills/review-code/SKILL.md on GitHub (opens in a new tab) -
review-completion
Confirm a task was fully executed and the change works — static completeness audit followed by empirical runtime evidence. TRIGGER when asked to confirm a task is complete, prove it works, or verify a change is ready to ship.
tools/agents/config/skills/review-completion/SKILL.md on GitHub (opens in a new tab) -
review-converge
Autonomously review and fix the current branch or specified scope in iterative rounds until clean, leaving all changes in the working tree. Escalates only genuine design decisions. Ends with a transparent report of every round, every fix, and anything it couldn't resolve.
tools/agents/config/skills/review-converge/SKILL.md on GitHub (opens in a new tab) -
review-pr-comments-converge
Fetch PR review comments, validate each against the actual code, auto-fix obvious issues, and escalate genuine design decisions. Leaves all changes in the working tree. Use when you want to action reviewer feedback autonomously.
tools/agents/config/skills/review-pr-comments-converge/SKILL.md on GitHub (opens in a new tab) -
review-prs
Fetch and present a prioritized summary of all PRs awaiting the current user's review across the relevant projects and provide an interactive workflow helping the user phrase and post inline review comments and overall review decisions.
tools/agents/config/skills/review-prs/SKILL.md on GitHub (opens in a new tab) -
scan-gaps
Analyze gaps in user-facing features and desirable characteristics, developer-facing tooling and desirable characteristics, and other opportunities not currently tracked in the project's backlog. Use when the user asks you to help identify opportunities to improve the system.
tools/agents/config/skills/scan-gaps/SKILL.md on GitHub (opens in a new tab) -
scan-harness
Audit the user's Claude Code agent harness for improvements — global config, project config, recent session patterns, and opportunities for better guardrails and feedback loops. Use when the user asks to improve their Claude Code setup.
tools/agents/config/skills/scan-harness/SKILL.md on GitHub (opens in a new tab) -
scan-ideas
Find all tracked issues and work item ideas for the current project and rank them by priority to address. TRIGGER whenever the user asks for help deciding what to work on next and you are not already working through a known plan.
tools/agents/config/skills/scan-ideas/SKILL.md on GitHub (opens in a new tab) -
scan-impact
Identify the most mind-blowing, game-changing changes that could be made next assuming users will shortly abandon this project if it doesn't differentiate itself soon. TRIGGER whenever the user asks what work would be most impactful to do next.
tools/agents/config/skills/scan-impact/SKILL.md on GitHub (opens in a new tab) -
scan-standards
Check whether a codebase upholds its standards — a specific theme or all themes in parallel. Use when asked to review conventions, check standards, or audit codebase health.
tools/agents/config/skills/scan-standards/SKILL.md on GitHub (opens in a new tab) -
uphold-standards
Load the universal engineering standards relevant to the change at hand (decision-making and ADRs, architecture, testing, security, type design, documentation, etc.) and apply them. Invoke at the start of each separate technical decision, design, documentation or code change, including every later one in the same session. An earlier invocation covers only the change it preceded and never the next…
tools/agents/config/skills/uphold-standards/SKILL.md on GitHub (opens in a new tab) -
use-argo
Diagnose Argo CD application health, sync status, and deployment issues. Use when troubleshooting application deployments, checking sync status, viewing resource health, or identifying configuration drift.
tools/agents/config/skills/use-argo/SKILL.md on GitHub (opens in a new tab) -
use-beads
Full reference for the beads task management workflow. Use when working with beads issues, planning multi-step work, or managing task lifecycle.
tools/agents/config/skills/use-beads/SKILL.md on GitHub (opens in a new tab) -
use-codefresh
Reference for using Codefresh via the CodeFresh CLI. Use when a Codefresh CI check is failing in a recursionpharma PR, or when working with Codefresh builds.
tools/agents/config/skills/use-codefresh/SKILL.md on GitHub (opens in a new tab) -
use-gh
gh CLI gotchas that waste context or post malformed comments and reviews to real PRs and issues. Read before every gh invocation, reads included, because default output silently omits comments and relationships and a bad post cannot be un-notified. Re-invoke each time.
tools/agents/config/skills/use-gh/SKILL.md on GitHub (opens in a new tab) -
use-linear
Reference for using Linear via MCP tools. Use when creating, updating, or querying Linear issues, projects, teams, or comments.
tools/agents/config/skills/use-linear/SKILL.md on GitHub (opens in a new tab) -
use-next-devtools
Reference for using the NextJS Dev Tools via the nextjs-agent. Use to debug or observe Next.js framework internals.
tools/agents/config/skills/use-next-devtools/SKILL.md on GitHub (opens in a new tab) -
use-notion
Reference for using the Notion API via the notion-agent subagent. Use to expore and update Notion workspace content.
tools/agents/config/skills/use-notion/SKILL.md on GitHub (opens in a new tab) -
use-trekker
Full reference for the trekker task management workflow. Use when working with trekker issues, planning multi-step work, or managing task lifecycle.
tools/agents/config/skills/use-trekker/SKILL.md on GitHub (opens in a new tab) -
write-pr-description
Voice guide for writing PR descriptions. Use this skill for ALL PR creation and updates (via gh CLI or editing existing PRs). Contains your specific voice rules, anti-patterns, examples, and workflow. Never write PR descriptions without invoking this skill first.
tools/agents/config/skills/write-pr-description/SKILL.md on GitHub (opens in a new tab) -
write-ticket-description
Voice guide for writing issue/ticket/task/epic descriptions. Use this skill for ALL issue creation — GitHub issues, Jira tasks, Monday tasks, Linear tasks, and epics. Contains section structure, voice rules, and anti-patterns. Never write ticket descriptions without invoking this skill first.
tools/agents/config/skills/write-ticket-description/SKILL.md on GitHub (opens in a new tab) -
drafting-til
Draft a TIL-style blog post in the user's voice and write it to Notion with Status="Claude Draft". Contains voice guide for matching the user's writing style. Use when user approves a TIL topic and wants a draft created.
tools/claude/config/@archive/skills/draft-til-style-blog-post/SKILL.md on GitHub (opens in a new tab)
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.