AMY PELLEGRINI’S WORKFLOW / SKILLS & AGENTS

Amy Pellegrini’s workflow.
Still evolving.

These are the skills and agents I use in my own development workflow. I’m sharing them in case they’re useful to you, too. There are rough edges, and I keep refining them as I learn what works. Feel free to borrow, adapt, and make them your own.

Install a skill
22 reusable skills2 agent definitions6 categoriesAny repository

01 / EXPLORE

The library

JSON registry ↗

One maintained definition per workflow. Skills discover your project’s tools and conventions; agent definitions provide optional Claude Code orchestration.

24 entries

skillportable

assess-ci

Audit the repository’s CI coverage against its documented quality requirements and report evidence-backed gaps.

QualityInstall & read →
skillportable

commit

Create focused Git commits with accurate messages and verification appropriate to the change.

DeliveryInstall & read →
skillportable

desk-check

Demonstrate work in progress, collect criterion-level feedback, and preserve what was actually reviewed.

ReviewInstall & read →
skillportable

dev

Drive a scoped feature through implementation, validation, and a reviewable handoff using the target repository’s conventions.

DevelopmentInstall & read →
skillportable

open-pr

Open a pull request with a focused description, the correct base branch, and relevant validation evidence.

DeliveryInstall & read →
skillportable

pickup-issue

Prepare an issue for implementation by checking requirements, repository context, and a suitable working branch.

PlanningInstall & read →
skillportable

qa

Coordinate either a repository quality assessment or acceptance-criteria verification of a specific feature.

QualityInstall & read →
skillportable

qa-test

Verify a feature against its acceptance criteria on the actual implementation and record reproducible evidence.

QualityInstall & read →
skillportable

sign-off

Guide a human acceptance review of a specific build and record explicit criterion-level decisions.

ReviewInstall & read →
skillportable

tdd

Implement one acceptance criterion through a verified red, green, and refactor cycle using the project’s test tools.

DevelopmentInstall & read →
agentclaude-code

dev

Coordinate scoped feature development and return validated, reviewable changes without assuming a particular repository or stack.

OrchestrationSetup & read →
agentclaude-code

qa

Assess repository quality or verify feature behavior with reproducible evidence while leaving implementation code unchanged.

OrchestrationSetup & read →

02 / MAKE IT YOURS

From this library
to your workflow.

Use Vercel’s Skills CLI with Node.js and npm installed. Run commands inside the project where you want the skill. These commands target the published library repository; use the local path below before publication.

  1. Browse the available skills

    Preview the library before installing a skill. This lists the skills available in the library.

    npx skills add amypellegrini/amypellegrini.github.io --list

  2. Install the skill you need

    Each entry has a command. Choose a target with --agent claude-code, --agent codex, or --agent pi, or use the interactive selection. Add --global for your user account; omit it for the current project.

    npx skills add amypellegrini/amypellegrini.github.io --skill tdd --agent claude-code

  3. Check your installation

    List installed skills, or use npx skills update to update them later.

    npx skills list

Working from a local checkout?

From the root of this website repository, you can preview the maintained skills without publishing:

npx skills add ./skills --list

Skills and agents are different

The CLI installs SKILL.md packages. Claude Code agent definitions belong in your project’s .claude/agents/ directory. Open an agent entry to download its file and see its destination. Installing the dev or qa skill does not also install its agent.

Adapts to your project

Skills discover the repository, default branch, test commands, tracker, and workflow states from your project. Boards, devices, and companion agents are optional unless the task needs them. Install only the workflows you use; each includes a fallback when a companion skill is absent.

03 / MAINTAINED TOGETHER

Your repository.
Your conventions.

These workflows make no assumptions about your organization, product, programming language, branch names, or board columns. They preserve the useful discipline: focused changes, evidence-backed testing, clear review, and explicit human acceptance.

Editable skills

Each skills/<name>/SKILL.md is a self-contained workflow. Edit it here, or adapt an installed copy to your project.

Optional agents

The dev and qa definitions coordinate workflows in Claude Code. Portable skills can also run directly without these agents.

Inspectable registry

The JSON registry records categories, file paths, SHA-256 checksums, source links, and install commands.

Definitions are maintained in this library. Refreshing the registry indexes those files; it never re-imports instructions from another project.