Skip to content

Package Stand Up a Repo as a Skill - #683

Merged
ptr727 merged 1 commit into
developfrom
package-standup-a-repo-as-skill
Aug 13, 2026
Merged

Package Stand Up a Repo as a Skill#683
ptr727 merged 1 commit into
developfrom
package-standup-a-repo-as-skill

Conversation

@ptr727

@ptr727 ptr727 commented Aug 13, 2026

Copy link
Copy Markdown
Owner

Phase 7 of the hub-docs-to-skills conversion project.

What

  • New standup-a-repo Skill at .agents/skills/standup-a-repo/SKILL.md: a
    hub-only driver over STANDUP.md's create-to-conformance procedure, run
    from a hub checkout for a named target repo the maintainer is standing up.
  • Same non-trimming pattern Phase 4 (resync-a-repo) used: STANDUP.md is
    hub-only and never carried downstream, so there's no duplicate-copy
    problem to solve by pointer-izing it. The source file stays the full
    authoritative procedure; the skill is a driver layered on top.
  • STANDUP.md section "2. Carry the Baseline Files" gains an explicit step
    to carry AGENTS.md's skill-dependency pointer paragraph (naming
    scripts/skills_install.py and where the fleet's Skills live) as one more
    verbatim unit, the identical requirement Phase 4 added to RESYNC.md
    section 3 for a repo already stood up.
  • AGENTS.md's "Onboarding a repo or running a conformance sweep" table row
    now names both standup-a-repo and resync-a-repo.
  • .claude-plugin/fleet-skills/ regenerated via scripts/build_dist.py.

Checks done before pushing

  • spec/files.json, spec/project-types.json, scripts/test_*.py grepped
    for STANDUP.md coupling before editing: none found, safe to edit freely.
  • python3 scripts/prose_lint.py clean on the whole tree.
  • No inline Markdown links in the new skill file (reference-style/backtick
    convention only).
  • No semicolons or em-dashes introduced (verified against the pre-existing
    baseline in each touched file).
  • CRLF preserved byte-for-byte in every touched/created file, no stray LF.
  • No mid-span code-span line wraps (`python3 scripts/host_gate.py` and
    `repo-config/configure.sh apply owner/repo release|operational`
    each stay on one line).
  • python3 scripts/build_dist.py --check reports the plugin current.

🤖 Generated with Claude Code

Phase 7 of the hub-docs-to-skills conversion: standup-a-repo, a
hub-only driver over STANDUP.md's create-to-conformance procedure,
same non-trimming pattern Phase 4 used for resync-a-repo since
STANDUP.md is never carried downstream.

STANDUP.md section 2 gains an explicit step to carry AGENTS.md's
skill-dependency pointer paragraph as one more verbatim unit, the
same requirement Phase 4 added to RESYNC.md section 3 for a repo
already stood up.

AGENTS.md's "Onboarding a repo or running a conformance sweep" table
row now names both standup-a-repo and resync-a-repo.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Copilot AI lite review requested due to automatic review settings August 13, 2026 18:49

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR continues the hub-docs-to-skills conversion by introducing a new hub-only standup-a-repo Skill that drives the ordered standup procedure in STANDUP.md, and wires it into the fleet-skills plugin distribution.

Changes:

  • Add a new standup-a-repo Skill (hub-context driver over STANDUP.md) and include it in the generated fleet-skills plugin.
  • Update STANDUP.md to explicitly require carrying AGENTS.md's skill-dependency pointer paragraph as part of the baseline carry step.
  • Update AGENTS.md to reference both standup-a-repo and resync-a-repo in the rules/skills mapping table.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated no comments.

Show a summary per file
File Description
STANDUP.md Adds an explicit baseline-carry step for the AGENTS.md skills-install pointer paragraph.
AGENTS.md Updates the “Where the Rules Live” table to include standup-a-repo alongside resync-a-repo.
.agents/skills/standup-a-repo/SKILL.md Introduces the new standup skill content (hub-only driver over STANDUP.md).
.claude-plugin/fleet-skills/skills/standup-a-repo/SKILL.md Adds the generated plugin copy of the new standup skill.
.claude-plugin/fleet-skills/.claude-plugin/plugin.json Registers ./skills/standup-a-repo in the fleet-skills plugin manifest.
.claude-plugin/fleet-skills/.source-digest Updates the plugin source digest after regeneration.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@ptr727
ptr727 merged commit 75a0d45 into develop Aug 13, 2026
7 checks passed
@ptr727
ptr727 deleted the package-standup-a-repo-as-skill branch August 13, 2026 18:54
ptr727 added a commit that referenced this pull request Aug 15, 2026
…Python CI Gates (#718)

Thirty-one squashes, `56f4d7d..d54862a`. 115 files, +20436/-5298.

**Merge with a merge commit, never a squash, and never with
`--delete-branch`.** This pull request's head is `develop` itself.

## What lands

**Fleet Skills.** The `.agents/skills/` source tree, the generated
`.claude-plugin/` distribution, `scripts/build_dist.py` with its
`--check` gate, and `scripts/skills_install.py` with its host stamp
(#676). Packaged as skills on top of the scaffold: PR review conduct and
Copilot instructions upkeep (#677), comment and doc style (#678),
resync-a-repo and fleet-conformance-check (#679), the per-language
codestyles (#680), git commit conventions and operational vs release
workflow (#681), stand up a repo (#683), and repo-worktree (#717).
Coverage gaps closed in three passes (#690, #691, #692) plus the P4
sentence-length opt-in (#697).

**Host setup.** The Windows host-setup tooling and its PowerShell gate
(#674), the Windows bootstrap loader (#682), Docker install and upgrade
on Linux and Windows with a version floor (#701, #705), a `uv` floor in
`spec/host-tools.json` (#698), self-healing of a shadowing `uv`, `jq`,
or `git-restore-mtime` copy (#689), node's real winget package id
(#696), and a README for the Linux host-setup nuances (#710).

**Python and CI.** Python tooling in CI with the script tests moved to
`scripts/tests` (#704), `ruff format` adopted and gated (#709), and the
PSScriptAnalyzer claim conditioned on repos that carry `.ps1` files
(#686).

**Conduct rules.** Triage-order and scope guardrails in
pr-review-conduct (#684), `pr_review.py wait` requesting a review rather
than only polling for one (#685), a tech-agnostic signed-commit
verification (#708), execution rather than analogy to verify
platform-specific code (#715), and a unique worktree for every task
(#717).

**Docs.** The fleet map and gap register with peer messaging declared
(#687), mermaid flow diagrams in the kept-authority docs (#702), and the
map pointed at the shipped diagrams and current tooling (#703).

## Issues this promotion closes

Each landed on `develop` on its own pull request. The keyword fires only
on a merge into `main`, so it sits here rather than on the feature pull
requests.

Closes #700
Closes #707
Closes #711
Closes #712
Closes #714
Closes #688

#699 stays open on purpose: #717 shipped the layout convention and the
skill, and the physical migration of existing checkouts is still tracked
there.

## Review record

Every squash closed its own Copilot loop on its own pull request before
merging to `develop`. This promotion carries no new content of its own,
so its review is the merged tree as a whole.

## Consequence worth stating

The `GOVERNANCE.md` and `AGENTS.md` sections these squashes changed
become the canonical the moment this reaches `main`, and every carrying
repository reads as drifted from that point until it resyncs. That is
the ordinary consequence of a canonical moving rather than a defect. The
Skills installer added here is also how a machine picks the new skills
up, so a session that keeps restating a rule already packaged as a skill
is the signal to run it.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants