docs: fix label names, add Publishing section, correct test runner flags#64
Draft
github-actions[bot] wants to merge 1 commit intomainfrom
Draft
Conversation
Four documentation gaps found during routine doc sweep: - README.md: Uninstall section listed `state:in-progress` for agent-team label cleanup, but the label the install skill actually creates is `agent-team:reviewed`. Fixed to match the skill and catalog/agent-team README verbatim. - README.md: Added missing `## Publishing` section. CONTRIBUTING.md has a "Publishing (maintainers only)" heading that links to `README.md#publishing`, but that anchor did not exist, leaving a broken reference. - CONTRIBUTING.md: Testing section said "no automated test harness" but `tests/run-tests.sh` runs tier-2 invariants + tier-1 skill assertions on every CI run. Rewrote the section to reference the runner and point to tests/README.md. - tests/README.md: Table row for `test-e2e.sh` said to opt in via `--tier3`, a flag that does not exist in `run-tests.sh`. Clarified that `test-e2e.sh` must be invoked directly and is never managed by the runner. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
github-actions
Bot
added
automation
documentation
This was referenced Apr 21, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Four documentation gaps found during a routine doc sweep against the current code:
Changes
README.md— wrong label in Uninstall sectionThe uninstall instructions listed
state:in-progressas one of the seven agent-team labels to delete. The label thatinstall-agent-teamactually creates isagent-team:reviewed(verified againstskills/install-agent-team/SKILL.mdandcatalog/agent-team/README.md). Fixed the list to match.README.md— missing## PublishingsectionCONTRIBUTING.mdhas a "Publishing (maintainers only)" heading that links toREADME.md#publishing, but that anchor did not exist — a broken reference on every contributor's first PR. Added a concise Publishing section covering version bump, tagging, GitHub release, and registry submissions.CONTRIBUTING.md— Testing section claimed no automated test harnessThe section opened with "There is no automated test harness for skills" but
tests/run-tests.shruns tier-2 invariants + tier-1 skill assertions on every CI run. Rewrote the section to show the runner commands and point totests/README.mdfor the full tier breakdown.tests/README.md—--tier3flag doesn't existThe tier-3 table row for
test-e2e.shsaid to opt in via--tier3, butrun-tests.shhas no such flag (--with-e2ecovers the daily light E2E only;test-e2e.shmust always be invoked directly). Updated the cell to say "invoke directly" with the correct command.Test plan
test-invariants.shstill passes (theREADME.md#publishinganchor check is not in invariants, but the version-sync and dogfood-path checks still apply)gh label createcommands inskills/install-agent-team/SKILL.mdREADME.md#publishinglink fromCONTRIBUTING.mdand confirm it resolves🤖 Generated with [Claude Code]((claude.com/redacted)