ok

Administers the ok-* plugin suite by updating plugins, discovering skill families, and converging vendored project layers.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping a project's vendored ok-* skill families, ceremony verbs, hooks, and settings wiring in sync with the installed plugin versions requires many manual steps; this Skill consolidates the entire administration process into a single /ok command. ## Core Features & Use Cases - One-command suite upkeep: Updates installed user-scoped plugins, discovers integrated skill families by filesystem markers, and offers to bootstrap the rest in one consent question. - Deterministic converge with judgment layer: Drives each family's admin/converge core (diagnose, converge, wire-hooks) alongside its ADMINISTRATION.md document for migrations, conflicts, and declarations. - Consented settings wiring: Collects all WIRING NEEDED blocks and writes hook and env entries to .claude/settings.json only through explicit per-block owner consent. - Use Case: After cloning a project that vendors ok-planner and ok-plumbline, run /ok to diagnose both families, migrate any retired layout, re-stamp the vendored layers to the carried version, and wire the hooks in one pass. ## Quick Start Type /ok in the project to update the installed plugins and converge every integrated skill family to the carried version.

Frequently Asked Questions about ok

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

FAQPage Schema
How do I update and converge the ok-* plugin suite in a project?▼

Run the /ok slash command in the project. It updates installed ok-plugins, discovers integrated skill families by their filesystem markers, offers to bootstrap the rest, then diagnoses and converges each family in one pass.

How does /ok discover which skill families a project uses?▼

Discovery is purely filesystem-based: a family is integrated if its marker directory .ok-<name>/ exists at the project root, or a documented pre-migration marker exists, such as .plumbline.json or .claude/rules/plumbline-cheatsheet.md for ok-plumbline.

Does /ok modify .claude/settings.json automatically?▼

No. Hook and env entries are presented as WIRING NEEDED blocks, each with an exact consent command. Nothing is written until the owner approves each block individually, and each block is its own consent decision.

Can /ok install the ok-conduct plugin or other plugins?▼

No. The front door only updates already-installed ok-plugins and never installs new ones. The ok-conduct plugin is personal and user-scoped; /ok never installs, vendors, or offers it.

What happens if I decline bootstrapping a skill family?▼

Declining is recorded as 'not integrated (declined)', which is a valid state rather than drift. The family is skipped for that run, and /ok will ask again no sooner than its next run.