New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Piv Implement

by coleam00 in coleam00/skills

Executes an implementation plan task-by-task with validation at every step.

MITAuto-check passedAgent Workflows

Install Piv Implement

skills CLI
$ npx skills add coleam00/skills --skill piv-implement -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install coleam00/skills piv-implement --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/coleam00/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/piv-implement .claude/skills/piv-implement && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
piv-implement
GitHub stars
670
Token cost
~1k tokens
SKILL.md length
497 words
Files
1
Skills in repo
34
Repo updated
First seen
Licence
MIT

At a glance

Executes an implementation plan task-by-task with validation at every step.

  • Works in 5 steps: Read and Understand → Execute Tasks in Order → Implement Testing Strategy → …
  • You have a completed feature plan and want to implement it in one pass
  • SKILL.md covers Plan to Execute, Before you start — work on a…, Execution Instructions and Output — write an…, plus 1 more section
  • Calls git

What it does

Piv Implement is an agent skill from coleam00/skills. Executes an implementation plan task-by-task with validation at every step. Use when you have a completed feature plan and want to implement it in one pass.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Planning. The repository describes itself as: The agent skills I actually use to build software with coding agents. The PIV loop, planning, worktrees, and the meta-skills for building your own AI Layer. The licence is MIT.

When your agent uses it

  • You have a completed feature plan and want to implement it in one pass
  • Tasks that involve Planning

Example prompts

  • “Use the piv-implement skill to execute an implementation plan task-by-task with validation at every step”
  • “/piv-implement”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Read and Understand
  2. Execute Tasks in Order
  3. Implement Testing Strategy
  4. Run Validation Commands
  5. Final Verification

What it can do on your machine

Read from SKILL.md and the folder at commit 847be08. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Piv Implement loads about 1k tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 497 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~43
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from coleam00/skills at commit 847be08, republished under its MIT licence (© coleam00). 497 words, ~1,043 tokens.

Download SKILL.mdSave it as .claude/skills/piv-implement/SKILL.md (or your agent's skills folder).
name
piv-implement
description
Executes an implementation plan task-by-task with validation at every step. Use when you have a completed feature plan and want to implement it in one pass.
argument-hint
path-to-plan

Execute: Implement from Plan

Plan to Execute

Read plan file: $ARGUMENTS

Before you start — work on a feature branch

A ticket gets built on its own branch, so it can become one PR. Ideally you're already on that branch — cut it before planning — so the plan commit you made is on it and rides into the PR; a plan committed on the base branch won't be in this branch's PR. If you're still on base, this step creates the branch now. Detect the base branch (don't hardcode main): git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's@^refs/remotes/origin/@@' (fallback main).

  • On the base branch, clean → create one: git checkout -b feature/<plan-slug>.
  • Already on a feature branch or in a worktree → use it.
  • On the base branch with uncommitted changes → STOP: commit or stash first.

(One branch per ticket is also what makes parallel worktrees clean later.)

Execution Instructions

1. Read and Understand
  • Read the ENTIRE plan carefully
  • Understand all tasks and their dependencies
  • Note the validation commands to run
  • Review the testing strategy
2. Execute Tasks in Order

For EACH task in "Step by Step Tasks":

a. Navigate to the task
  • Identify the file and action required
  • Read existing related files if modifying
b. Implement the task
  • Follow the detailed specifications exactly
  • Maintain consistency with existing code patterns
  • Include proper type hints and documentation
  • Add structured logging where appropriate
c. Verify as you go
  • After each file change, check syntax
  • Ensure imports are correct
  • Verify types are properly defined
  • Run the task's own VALIDATE command before starting the next task. Every task in the plan carries one. A task is not done until its check passes — if it fails, fix it now rather than carrying the failure forward. The full suite still runs at step 4; this is the per-task gate that keeps step 4 from becoming a pile-up.
Show full SKILL.md (192 more words)Show less
3. Implement Testing Strategy

After completing implementation tasks:

  • Create all test files specified in the plan
  • Implement all test cases mentioned
  • Follow the testing approach outlined
  • Ensure tests cover edge cases
4. Run Validation Commands

Execute ALL validation commands from the plan in order:

bash
# Run each command exactly as specified in plan

If any command fails:

  • Fix the issue
  • Re-run the command
  • Continue only when it passes
5. Final Verification

Before completing:

  • ✅ All tasks from plan completed
  • ✅ All tests created and passing
  • ✅ All validation commands pass
  • ✅ Code follows project conventions
  • ✅ Documentation added/updated as needed

Output — write an implementation report

Write a short report to .claude/reports/<plan-slug>-report.md (and print the summary). This is what the PR body and the piv-review-pr gate read — especially the deviations (a documented deviation is an intentional decision the reviewer should not flag):

markdown
# Implementation Report — <feature>

**Plan**: <path>   **Branch**: <feature/...>   **Status**: COMPLETE | PARTIAL

## Summary
{What was built, 2-4 sentences.}

## Tasks completed
- [task] → `path/to/file` (CREATE/UPDATE)

## Tests added
{Test files + cases + results.}

## Validation results
{Type-check / lint / tests / build — pass/fail with counts.}

## Deviations from the plan
{What changed vs the plan and WHY — or "none". This is the reviewer's signal of intent.}

## Issues encountered
{Anything notable, or "none".}
Ready for the next step
  • Confirm all changes are complete and validations pass.
  • Next: piv-commit the work, then piv-create-pr to open the PR (the report fills the PR body), then piv-review-pr.

Notes

  • If you encounter issues not addressed in the plan, document them
  • If you need to deviate from the plan, explain why
  • If tests fail, fix implementation until they pass
  • Don't skip validation steps

© coleam00, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/piv-implement of coleam00/skills.

Open the folder on GitHubat commit 847be08

Compare with similar skills

Piv Implement next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Piv Implement compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Piv Implement this skillcoleam00/skills670—~1kAutomated safety check: PassMIT
Executing Plans Inlineobra/superpowers296k2 repos~5.1kAutomated safety check: PassMIT
Interview Meaddyosmani/agent-skills103k6 repos~3.8kAutomated safety check: PassMIT
OpenSpec Guided OnboardingFission-AI/OpenSpec71k1 repos~4.5kAutomated safety check: PassMIT
Writing Plansgeeksblabla/stateofdev.ma16357 repos~661Automated safety check: PassNone
Subagent Driven DevelopmentAsvarox/allkaraoke26138 repos~1.2kAutomated safety check: PassNone

Similar skills

  • Executing Plans Inline

    obra/superpowers

    Has the agent carry out an implementation plan itself, task by task in the current session, keeping a ledger, proving each step with a test and ending with one whole-branch review.

    296k GitHub starsUsed in 2 repos~5.1k tokens
    Agent WorkflowsAuto-check passed

  • Interview Me

    addyosmani/agent-skills

    Asks one question at a time, each with a best guess attached, until the agent is about 95 percent sure what you really want, before any plan, spec or code.

    103k GitHub starsUsed in 6 repos~3.8k tokens
    Agent WorkflowsAuto-check passed

  • OpenSpec Guided Onboarding

    Fission-AI/OpenSpec

    Walks you through a complete OpenSpec workflow cycle with narration while doing real work in your codebase.

    71k GitHub starsUsed in 1 repo~4.5k tokens
    Agent WorkflowsAuto-check passed

  • Writing Plans

    geeksblabla/stateofdev.ma

    A skill your agent uses when design is complete and you need detailed implementation tasks for engineers with zero codebase context - creates comprehensive implementation plans with exact file…

    163 GitHub starsUsed in 57 repos~661 tokens
    Agent WorkflowsAuto-check passed

  • Subagent Driven Development

    Asvarox/allkaraoke

    A skill your agent uses when executing implementation plans with independent tasks in the current session

    261 GitHub starsUsed in 38 repos~1.2k tokens
    Agent WorkflowsAuto-check passed

  • Planning With Files

    jd-opensource/JoySafeter

    Implements Manus-style file-based planning for complex tasks.

    313 GitHub starsUsed in 19 repos~1.8k tokens
    Agent WorkflowsAuto-check: notes

More from coleam00/skills

All 34 skills in this repo

  • Ablate AI Layer

    coleam00/skills

    Measure whether a repository's AI instructions still earn their place, by running the same real task many times with the layer intact and with it stripped, then grading every rule against what…

    670 GitHub stars~1.9k tokensUpdated yesterday
    Auto-check passed

  • Build Dark Factory

    coleam00/skills

    Take a PRD and build a dark factory around it - a repository that takes work in as an issue and ships validated code out with nobody at the keyboard - one component at a time, into the user's actual…

    670 GitHub stars~12k tokensUpdated yesterday
    Auto-check passed

  • Drive Screen

    coleam00/skills

    Take real control of the desktop - list and focus windows, type, paste, click, scroll, and screenshot - on Windows, macOS or Linux, and drive other coding-agent sessions running in terminals.

    670 GitHub stars~5.4k tokensUpdated yesterday
    Auto-check passed

  • Second Brain Audit

    coleam00/skills

    Audit any second brain, notes folder, or agent memory for facts that have quietly stopped being true, then fix the worst one so it stops recurring.

    670 GitHub stars~4.6k tokensUpdated yesterday
    Auto-check passed

  • Build Signal Engine

    coleam00/skills

    Build a personal signal engine from scratch - a system that reads every source someone cares about each day (changelogs and release notes, communities, feeds, videos, papers), makes a quick decision…

    670 GitHub stars~2.9k tokensUpdated yesterday
    Auto-check passed

  • Worktree Create

    coleam00/skills

    Create one or more git worktrees for parallel development, each on its own branch with gitignored config copied in, dependencies installed, and a health check, by fanning out a setup subagent per…

    670 GitHub stars~958 tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Piv Implement

What does Piv Implement do?

Executes an implementation plan task-by-task with validation at every step. Piv Implement is an agent skill from coleam00/skills. Executes an implementation plan task-by-task with validation at every step.

When should I use Piv Implement?

Piv Implement fits situations like: you have a completed feature plan and want to implement it in one pass; tasks that involve Planning.

How do I install Piv Implement in Claude Code?

Run `npx skills add coleam00/skills --skill piv-implement -a claude-code`. Or copy the skill folder (.claude/skills/piv-implement in coleam00/skills) into .claude/skills/piv-implement in your project. Claude Code loads it when a task matches its description.

How do I install Piv Implement in Codex?

Run `npx skills add coleam00/skills --skill piv-implement -a codex`. Or copy the skill folder (.claude/skills/piv-implement in coleam00/skills) into .agents/skills/piv-implement in your project. Codex loads it when a task matches its description.

Can I use Piv Implement in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add coleam00/skills --skill piv-implement -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/piv-implement, .gemini/skills/piv-implement, .github/skills/piv-implement and .opencode/skills/piv-implement in your project.

What does Piv Implement need to run?

Going by SKILL.md and its folder, Piv Implement needs the command-line tools its instructions call (git).

Does Piv Implement access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Piv Implement safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Piv Implement use?

Piv Implement is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Piv Implement use?

About 1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Piv Implement?

Skills that share tags, products or a category with Piv Implement: Executing Plans Inline (obra/superpowers, 296k stars), Interview Me (addyosmani/agent-skills, 103k stars), OpenSpec Guided Onboarding (Fission-AI/OpenSpec, 71k stars) and Writing Plans (geeksblabla/stateofdev.ma, 163 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Piv Implement?

coleam00 (a GitHub user) maintains it in coleam00/skills, which has 670 GitHub stars. The repository holds 34 skills in this directory. The repository was last updated on October 7, 2026.

Source: coleam00/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.