starter

Generates a project-shaped plumbline config by scanning the repository for known patterns.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a plumbline configuration by hand requires knowing which directories to ignore and which citation entries to declare. This Skill inspects the repository and proposes a ready-to-review .ok-plumbline/config.json tailored to the project's actual shape. ## Core Features & Use Cases - Pattern Detection: Detects Go modules (go.mod), Node packages (package.json), ok-planner siblings (.ok-planner/), and generated-code directories (gen/, generated/, mocks/) anywhere in the tree. - Citation Entries: Adds @concept:, @story:, and @decision: citation entries that resolve against .ok-planner/design/{concepts,stories,decisions}/{slug}.md when an ok-planner sibling exists. - Strict-by-Default Checks: Comment hygiene, citation resolution, and no-tests checks always run; the generated config exposes no switch to disable them. - Use Case: After cloning a converged project, run the starter to propose a config at the project's own pinned binary version, review the suggested ignore list and citations, then save it as .ok-plumbline/config.json. ## Quick Start Ask the assistant to run /ok-plumbline:starter to scan this repository and propose a plumbline config for review.

Frequently Asked Questions about starter

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

FAQPage Schema
How do I generate a plumbline config for my project?▼

Run the /ok-plumbline:starter slash command, which scans the repository for known patterns and prints a proposed .ok-plumbline/config.json to stdout. Review the output with the assistant, then save it once you are satisfied.

What project patterns does the plumbline starter detect?▼

It detects Go modules via go.mod, Node packages via package.json, ok-planner siblings via the .ok-planner directory, and generated-code directories such as gen/, generated/, and mocks/ anywhere in the tree.

Can I disable plumbline checks in the generated config?▼

No. Comment hygiene, citation resolution, and no-tests checks always run, and the config exposes no switch to disable any of them. Plumbline is strict by default with no soft-start mode.

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

The skill falls back to the binary carried in the plugin payload and prints a note announcing this. This fallback exists because the starter often runs before the project has its own estate.

How do citation entries work in the plumbline config?▼

When an ok-planner sibling is detected, the starter adds @concept:, @story:, and @decision: citation entries that resolve against markdown files under .ok-planner/design/{concepts,stories,decisions}/{slug}.md.