gregoryfoster/skills

A shared library of Agent Skills for use across projects.

Skills are folders of instructions, scripts, and references that agents can discover and use to perform better at specific tasks.

Skills

Skill	Triggers	Description
reviewing-code-claude	CR, code review, perform a review	Structured code & documentation review with severity-tiered findings
reviewing-architecture-claude	AR, architecture review, architectural review	High-level architectural review across 11 structural dimensions
shipping-work-claude	ship it, push GH, close GH, wrap up	Commit, push, comment, and close GitHub issues
managing-skills-claude	add skill repo, add external skills, manage skills, update skills submodule	Add, update, and remove external skill repos using git submodules + symlinks

Structure

skills/
  <skill-name>/
    SKILL.md          # Required: frontmatter + instructions
    scripts/          # Executable scripts
    references/       # Supplementary docs (loaded on demand)

Usage

Point your agent at this repo's skills/ directory. For Claude Code and similar tools, add a <available_skills> block to your system prompt or AGENTS.md using the skills-ref CLI:

skills-ref to-prompt skills/reviewing-code-claude skills/reviewing-architecture-claude skills/shipping-work-claude

Consuming this repo

The recommended pattern for using these skills in your project is git submodule + symlinks:

# 1. Add as a submodule
git submodule add https://github.com/gregoryfoster/skills.git vendor/gregoryfoster-skills

# 2. Symlink the skills you want
mkdir -p skills
ln -s ../../vendor/gregoryfoster-skills/skills/reviewing-code-claude skills/reviewing-code-claude
ln -s ../../vendor/gregoryfoster-skills/skills/shipping-work-claude skills/shipping-work-claude

# 3. Commit
git add .gitmodules vendor/gregoryfoster-skills skills/
git commit -m "feat: add gregoryfoster/skills submodule"

Symlinked skills are auto-discovered by the agent framework. To override a global skill with project-specific behavior, replace the symlink with a committed directory of the same name.

See managing-skills-claude for the full procedure.

Project-level overrides

Projects can supersede any skill by placing a directory with the same name under their local /skills/ folder. The local version is a complete replacement — see AGENTS.md for details.

Spec

Follows the Agent Skills specification. Validated with skills-ref.

License

MIT