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
init-project-fastapi-claude	init project, bootstrap project, new fastapi project, set up foundation	Bootstrap a new FastAPI service with SSH deploy key, pyproject.toml, structured logging, TDD scaffold, vendor skill submodules, and GitHub issue tracking
orchestrating-issue-backlog-claude	orchestrate backlog, prioritize issues, plan issue execution, clear backlog	Prioritize an open issue backlog, analyze conflict zones, design a parallel-safe batch execution plan using git worktrees, and hand off to an agent team

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 skills-vendor/gregoryfoster-skills

# 2. Symlink the skills you want
#    (relative paths assume skills-vendor/ is at the repo root)
mkdir -p skills
ln -s ../../skills-vendor/gregoryfoster-skills/skills/reviewing-code-claude skills/reviewing-code-claude
ln -s ../../skills-vendor/gregoryfoster-skills/skills/shipping-work-claude skills/shipping-work-claude

# 3. Commit
git add .gitmodules skills-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