Skip to content
gtbuchananPublic

About

A personal collection of Agent Skills.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

84 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Taylor Buchanan's Agent Skills

A collection of Agent Skills — self-contained capabilities (a SKILL.md plus any supporting scripts and assets) that Claude loads on demand when a task matches the skill's description.

Skills

Skill Purpose
gtb-change-decomposition Plan a change into small, independently shippable units before writing code — where to cut, how to order the pieces so each stands alone, and when a change is better left whole.
gtb-gh-pr-authoring Author-side GitHub pull request conventions — opening one as a draft, what belongs in the title and description, watching checks after every push, and acting on review feedback once it is brought to you.
gtb-gh-pr-boundaries How planned units become GitHub pull requests — how many there are, where each branch starts, and when each one opens. Loaded before the first edit, because a branch already carrying the answer cannot be re-cut without redoing the work.
gtb-gh-pr-merging Landing a GitHub pull request, whether you wrote it or reviewed it — the merge method, the squash message and the credit it has to carry, deleting the head branch without closing what is stacked on it, and auto-merge.
gtb-gh-reviewer-followup Follow up on your GitHub PR review after the author pushes changes — re-review only what changed since your last pass, then resolve the threads that were fixed and reply to the ones that weren't (propose-then-confirm).
gtb-git-commit-conventions Git commit conventions — when to commit and how to write the message, including trailers, reverts, and untangling work already piled up in the working tree.
gtb-resolve-azp-deployment-backlog Clear a backlog of pending Azure Pipelines manual-approval deployments — reject every superseded approval and optionally approve only the newest.
gtb-technical-writing How to write prose an engineer reads: documentation, code comments, design notes, issue and pull request bodies. Sentence-level craft drawn from Orwell, Strunk and Pinker, each rule attached to the figure it names.

gtb-gh-reviewer-followup composes three internal building-block skills — gtb-gh-reviewer-followup-plan, gtb-reviewer-followup-verdict, and gtb-gh-reviewer-followup-apply — which are marked user-invocable: false (Claude composes them; they aren't direct / commands).

The verdict skill is the only one without a gh segment, and that is the point: it performs no I/O, so its judgment carries to any review tool that can hand it a diff and a list of threads. Everything GitHub-specific lives in its siblings.

gtb-change-decomposition needs an accompanying instruction

Install this one with a line in your always-loaded agent instructions (AGENTS.md, CLAUDE.md, or your agent's equivalent) telling the agent to load it. Something like:

When asked to plan or make changes in a repo, load the gtb-change-decomposition skill before your first edit. It governs how the work gets split into units, and that is decided while you work — consulting it once the change is written is too late.

The description alone will not carry it. Selection matches a request against the description, but the requests this skill most needs to reach — "fix the retry logic", "implement the caching layer" — contain no cue that looks like decomposition, and an agent that can already perform the task has little reason to consult a planning skill before doing so. Wording the description harder does not fix that: what an implementation request lacks is any cue to match, not a sufficiently emphatic one. The instruction is what loads it on that work.

That constraint is not unique to this skill, though the reason it applies elsewhere is different — see below. The rest describe a task the agent is being asked to perform, so their descriptions have something concrete to match against, and "commit this" or "open a PR" reaches them at the moment they are needed.

gtb-gh-pr-boundaries needs an accompanying instruction

Install this one the same way, for a different reason:

When making changes in a repo that will reach GitHub as a pull request, load the gtb-gh-pr-boundaries skill before your first edit. It decides how many pull requests the work becomes and what each one branches from, and a branch that already carries the answer cannot be re-cut without redoing the work.

Its description is reachable — "is this one PR or two" finds it. The problem is that by the time anyone asks, the branch exists. How many pull requests the work becomes, what each one branches from, and when each one opens are all settled while the code is written, so a skill reached when a pull request is being opened arrives after the decisions it governs.

Which is why it is a separate skill from gtb-gh-pr-authoring rather than a section inside it. The split is by deadline, not by subject: boundaries are always-loaded, mechanics are triggered. Loading the whole of the template, check-watch and review-feedback guidance before every edit would charge each task for machinery it does not need — the boundaries skill is a few dozen lines, and it is the half that was arriving late.

Contributing

See CONTRIBUTING.md for setup, authoring skills, and running the containerized eval suite.

About

A personal collection of Agent Skills.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages