port

Generates a phased Plumbline port plan enumerating lint violations and remediation passes.

1|Updated Jul 21, 2026
One-click install
npx skills add https://github.com/fallguyconsulting/ok-plugins --skill port-fallguyconsulting
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: port
Source: https://github.com/fallguyconsulting/ok-plugins/tree/main/plugins/ok/families/ok-plumbline/skills/port
Command: npx skills add https://github.com/fallguyconsulting/ok-plugins --skill port-fallguyconsulting

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Adopting the Plumbline lint methodology in an existing project means facing a backlog of comment-hygiene, citation-unresolved, and no-tests violations with no clear order of attack. This Skill produces a complete, phase-by-phase port plan that drives plumbline . to zero violations. ## Core Features & Use Cases - Violation audit: Runs plumbline diagnose, plumbline ., and plumbline patterns to count violations per check and cluster comment-hygiene findings by shape. - Phased plan generation: Emits ordered passes — Adopt, no-tests, citation-unresolved, comment-hygiene, Maintain — skipping passes whose check count is zero or whose diagnosis is already healthy. - Read-only by default: The plan is printed to the console and written to a file only when the owner explicitly names an output path. - Use Case: A team adopting Plumbline on a legacy repo runs the skill to get a markdown plan listing 1,200 comment-hygiene violations clustered by pattern, then hands the plan to a planner or executes it pass by pass. ## Quick Start Ask the assistant to run /ok-plumbline:port on the current project to print a complete Plumbline port plan, optionally naming an output path to save it.

Frequently Asked Questions about port

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a plan to adopt Plumbline in an existing project?▼

Run /ok-plumbline:port with the target directory as the first argument. It audits violations across all three checks, clusters comment-hygiene findings by pattern, and prints a phase-by-phase plan that ends with the lint returning clean.

What checks does the Plumbline port plan cover?▼

The plan covers three checks: comment-hygiene, citation-unresolved, and no-tests. Each check with a nonzero violation count gets its own remediation pass, and the plan always ends with a Maintain pass describing steady-state enforcement.

Does the port skill modify my project files?▼

No, it is read-only. The plan is printed to the console by default and written to a file only when you explicitly pass an output path as the second argument. Nothing in the project is applied or edited.

What happens if my project has no vendored plumbline binary?▼

The skill falls back to the plumbline binary carried in the ok plugin payload and prints a note announcing this. This lets you plan a port before the project has converged its own estate.

When is the Adopt pass skipped in the port plan?▼

The Adopt pass is skipped when `plumbline diagnose` reports a healthy installation state. Similarly, each check's pass is skipped when that check's violation count is zero, and a fully clean project yields a nothing-to-do result.