Facility

A collection of Agents, Skills, and Markdown tooling for Agentic development.

Installation

Clone the repo, then symlink the skills and agents into your Claude directory:

# Install everything (skills + agents)
./scripts/install.sh

# Install a specific skill
./scripts/install.sh --skill=shortcut

# Install a specific agent
./scripts/install.sh --agent=git-draft-commit

# Preview what would be linked without making changes
./scripts/install.sh --dry-run

Everything is symlinked (not copied), so edits in this repo are reflected immediately without re-running the installer.

# Uninstall everything
./scripts/uninstall.sh

# Uninstall a specific skill or agent
./scripts/uninstall.sh --skill=shortcut
./scripts/uninstall.sh --agent=git-draft-commit

Requirements: Claude Code v2.1.145+, Node.js (for skills that depend on CLI tools).

Skills

Skills extend Claude Code with domain-specific knowledge and commands. Each skill lives in skills/<name>/ and is available as /<name> in Claude Code once installed.

Skill	Command	Description
commit	/commit	Stage changes and commit with a drafted single-line message
pr	/pr	Draft and apply a pull request or merge request description
dr_pepper	/dr_pepper	Audit documentation and code comments for accuracy, relevance, and necessity
nit	/nit	Triage PR review feedback — dedupe, group by locality, rank by severity, auto-resolve outdated threads
guidance	/guidance	Turn user feedback into high-level agent guidance and record it in AGENTS.md, splitting large guidance into docs/agents/
shortcut	/shortcut	Work with Shortcut project management via shortcut-cli
gh	/gh	Work with GitHub via the gh CLI — PRs, issues, Actions, releases
glab	/glab	Work with GitLab via the glab CLI — MRs, issues, pipelines, releases
acli	/acli	Work with Jira and Atlassian Cloud via the acli CLI

commit

Guides Claude through staging changes and committing them with a well-drafted message. Works with any git remote.

What it covers:

• Inspects staged and unstaged changes before doing anything
• Prompts you to choose which unstaged changes (if any) to stage
• Drafts a concise, imperative-mood commit message (≤72 chars) matched to the repo's style
• Shows the message and file list for review before committing
• Never runs git commit without your explicit confirmation

pr

Drafts a pull request (GitHub) or merge request (GitLab) description from the current branch. Auto-detects the platform from the remote URL.

What it covers:

• Detects whether a PR/MR already exists for the branch and offers to update it, or creates a new one
• Gathers commits, file-level stats, and the full diff to write a focused Summary + Key Changes description
• Parses the branch name for a ticket/story reference (e.g. SC-123, PROJ-456) and includes it
• Shows the complete draft verbatim for review before applying, commenting, or creating
• Never creates or modifies a PR/MR without your explicit confirmation

dr_pepper

Audits documentation and code comments in a diff, commit, branch, file, or directory, flagging ones that are inaccurate, off-style, or add no value beyond a plain reading — the kind of noise LLMs tend to leave behind.

What it covers:

• Defaults to auditing uncommitted changes, or the current branch's diff against its base if nothing is uncommitted
• Can also be pointed at specific files, a directory, a commit, or a branch
• Checks each comment or doc passage for accuracy, idiom fit with the surrounding context, conciseness, and whether it adds value a plain reading wouldn't already give
• Flags flat restatements for removal and stale/verbose comments or docs for rewrite
• Shows every finding before touching anything, and never edits without explicit confirmation

nit

Triages review feedback on a GitHub PR — filters out threads GitHub already marked outdated, deduplicates repeated feedback, groups the rest by code locality, and prints a severity-ranked table.

What it covers:

• Fetches every review thread via gh api graphql (needed for isOutdated/isResolved, which REST doesn't expose)
• Auto-resolves threads GitHub already flagged as outdated — no confirmation needed, since GitHub itself already decided they're stale
• Merges near-identical feedback (same nit raised at multiple call sites, or restated by multiple reviewers) into one row
• Groups remaining feedback by file, directory, or feature area, whichever fits the PR's diff
• Ranks each row blocking → major → minor → nit → question, using the reviewer's own framing first and content second
• Never posts a comment or reply — resolving already-outdated threads is its only mutation

guidance

Takes a user concern or piece of feedback and converts it into standing agent guidance recorded in a repo's AGENTS.md. Short guidance is added inline; guidance that's large or complex (multi-step procedures, reference material, multiple sub-topics) is instead written to docs/agents/<topic>.md, with AGENTS.md updated to link to it via a file-tree-style listing.

What it covers:

• Translates raw feedback into forward-looking, do-oriented instructions rather than transcribing the complaint — prohibitions ("don't") are used only when the feedback is specifically about something to avoid
• Writes guidance as high-level as correctness allows, adding specifics only where the general rule would otherwise be ambiguous
• Strips incident-specific framing so the guidance reads as a standing rule, not a postmortem note
• Merges into an existing section rather than duplicating one when the topic already has coverage
• Applies a simple size/complexity heuristic to decide inline vs. dedicated doc
• Creates AGENTS.md and/or docs/agents/ from scratch if they don't exist yet
• Shows the full drafted content before writing anything, and never writes without explicit confirmation

shortcut

Integrates with shortcut-cli to let Claude search, view, create, and update Shortcut stories, epics, iterations, labels, teams, objectives, and docs.

Prerequisite:

npm install -g @shortcut-cli/shortcut-cli
short install

What it covers:

• Search and filter stories by owner, state, type, epic, iteration, label, and more
• View and update stories (state, estimate, title, comment, deadline, owners, labels)
• Create stories with full field support
• Create git branches from stories (--git-branch, --git-branch-short)
• Manage epics, iterations, labels, teams, objectives, and docs
• Raw API access via short api

Detailed flag reference is in skills/shortcut/references/.

gh

Integrates with the GitHub CLI (gh) to let Claude work with pull requests, issues, Actions workflow runs, repos, releases, gists, and secrets.

Prerequisite:

# macOS
brew install gh
# Linux / other: https://github.com/cli/cli#installation
gh auth login

What it covers:

• Create, view, list, review, merge, and comment on pull requests
• Create, view, list, close, and comment on issues
• Monitor and re-run Actions workflow runs; stream logs
• Clone, fork, and manage repositories
• Create and manage releases and gists
• Manage Actions secrets
• Raw REST and GraphQL API access via gh api

Detailed flag reference is in skills/gh/references/.

glab

Integrates with the GitLab CLI (glab) to let Claude work with merge requests, issues, CI/CD pipelines, releases, and CI/CD variables.

Prerequisite:

# macOS
brew install glab
# Linux / other: https://gitlab.com/gitlab-org/cli#installation
glab auth login

What it covers:

• Create, view, list, approve, merge, and comment on merge requests
• Create, view, list, close, and comment on issues
• Trigger pipelines, view status, and stream job logs; interactive TUI via glab ci view
• Clone and fork projects
• Create and manage releases
• Manage CI/CD variables (project and group level)
• Raw REST API access via glab api

Detailed flag reference is in skills/glab/references/.

acli

Integrates with the Atlassian CLI (acli) to let Claude create, search, view, edit, and transition Jira work items, and manage Jira projects, boards, sprints, and filters.

Prerequisite:

# Install acli (see https://atlassian.github.io/atlascode/ for platform-specific instructions)
acli jira auth login --web

What it covers:

• Search work items via JQL queries
• View, create, edit, and transition work items (bugs, tasks, stories, epics)
• Assign work items and manage comments
• List and manage projects, boards, sprints, filters, and dashboards
• Bulk operations via JQL, filter ID, or key list
• Administer Atlassian org users (with explicit confirmation)

Detailed flag reference is in skills/acli/references/.

Sub-Agents

Sub-agents are delegate prompts that skills spawn via the Agent tool to handle heavy, read-only work — keeping that context out of the main conversation window. Each agent lives in agents/<name>.md and returns a structured JSON result to its parent skill.

Agent	Used by	Description
git-draft-commit	/commit	Reads staged diff and drafts a commit message
git-draft-pr	/pr	Reads branch diff and drafts a PR/MR description
dr-pepper-audit	/dr_pepper	Reads a diff, commit, branch, file set, or directory and flags low-value or inaccurate comments and docs

(Un)License

This project is released into the public domain under the Unlicense.