@firstpick/pi-skill-patch-md

Agents should invoke this skill to create, update, or implement standardized PATCH.md documents that describe reproducible source code patches.

Packages

Package details

skill

Install @firstpick/pi-skill-patch-md from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:@firstpick/pi-skill-patch-md
Package
@firstpick/pi-skill-patch-md
Version
0.1.0
Published
May 27, 2026
Downloads
not available
Author
firstpick
License
MIT
Types
skill
Size
28 KB
Dependencies
0 dependencies · 0 peers
Pi manifest JSON
{
  "skills": [
    "./skills"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@firstpick/pi-skill-patch-md

A Pi skill for two patch workflows:

  1. Create/Update PATCH.md using a fixed, reproducible structure.
  2. Implement PATCH.md by applying the documented source changes exactly.

What it does

  • Adds the patch-md skill to Pi's skill library.
  • Enforces one canonical PATCH.md structure.
  • Defines a precise tool-call contract (patch_md_extract) for parsing PATCH.md into machine-readable execution data.
  • Helps agents produce implementation-ready patch docs and execute them safely.

Install

pi install npm:@firstpick/pi-skill-patch-md

Configuration

No required configuration.

Commands

None.

Tools

Skill-defined contract for integration:

  • patch_md_extract (recommended tool name)
    • Preferred parser script: skills/patch-md/scripts/patch_md_extract.mjs
    • Spec: skills/patch-md/TOOL-CALL-SPEC.md
    • Schema: skills/patch-md/patch-md-tool.schema.json

Modes:

  • Script mode (--strict, default) — preferred
  • Unstrict mode (--no-strict) — fallback for legacy PATCH.md variants

Example

User: Create PATCH.md for this bugfix and then implement it.
Agent: Invokes patch-md skill, writes standardized PATCH.md, then applies the patch and reports verification.