Menu
Use before repo-init-scan to cheaply decide whether a target repository already satisfies the current best-copilot init contract by reading only the root `best-copilot.md` sentinel.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Use when an agent needs the shared best-copilot contract for source priority, runtime adapters, init gates, work modes, dispatch packets, review, verification, memory, spec, state persistence, or closeout.
Use inside repo-init-scan after the official stage whenever scaffold verification, bounded repair, or `best-copilot.md` rewrite is still needed.
Use when coordinating large, ambiguous, cross-module, multi-agent, planning, dispatch, fan-in, closeout, or workflow-evolution work as the Senior Project Expert.
Use when maintaining requirements, design, tasks, ADRs, execution-plan state, closeout records, or memory/spec recovery as the Specification Writer.
Use when an approved tasks.md from a Spec Bundle, or a compact approved small-work plan, should be executed by fresh-context specialist subagents, with each task receiving implementation, spec-compliance review, code-quality review, and verification before closure. DO NOT USE FOR: missing plans, brainstorming, or simple single-file edits.
Create the target repository's local spec skeleton and reusable requirements/design/tasks templates. Use from repo-init-scan during first substantial plugin use, or from spec-writing flows when `spec/INDEX.md` or `spec/templates` is missing. Do not overwrite active project specs.
| name | repo-init-gate |
| description | Use before repo-init-scan to cheaply decide whether a target repository already satisfies the current best-copilot init contract by reading only the root `best-copilot.md` sentinel. |
Use this tiny skill before loading repo-init-scan. It is the repeat-request fast path.
When loaded, the next assistant action must be only this gate.
Preferred shell-capable path: run the bundled preflight helper from the target root when it is discoverable:
<best-copilot-skills-dir>/repo-init-gate/scripts/run-preflight.sh "$PWD" claude
For an installed Claude Code plugin, resolve the helper from CLAUDE_SKILL_DIR when present, or from the active plugin skills/ directory. The helper reads only the target root best-copilot.md on the fast path. If the sentinel frontmatter version is not current, it immediately delegates to repo-init-scan/scripts/bootstrap-after-gate-failure.sh, which owns official init, manual fallback, artifact verification, and the final ## Init Summary.
If the helper cannot be located or shell execution is unavailable, execute the inline gate exactly:
best-copilot.md, or determine that it is missing or unreadable.version to the current contract version below.## Repo Init Gate output block below.repo-init-scan; otherwise run repo-init-scan or its single-command bootstrap helper before any business-source read/search.Forbidden before this block: search, grep, glob, source reads, project structure exploration, code intelligence, planning, dispatch, implementation summaries, scaffold writes, or reading .github/instructions/**, memories/**, spec/**, AGENTS.md, or CLAUDE.md.
Canonical best-copilot.md content written by init:
---
version: "0.7.1"
---
version: "0.7.1": ready + skip_repo_init_scan.repo-init-scan.repo-init-scan.repo-init-scan owns sentinel creation/repair.HARNESS_DEGRADED skill_invocation_unavailable.## Repo Init Gate
- gate_result: ready|needs_init|version_mismatch|invalid_sentinel
- next_action: skip_repo_init_scan|run_repo_init_scan
- evidence: target_root_best_copilot_md=present|missing|unreadable, observed_version=<version-or-none>