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
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

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

(Un)License

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