Skip to content

docs: update CONTRIBUTING.md testing + publishing sections#76

Draft
github-actions[bot] wants to merge 1 commit intomainfrom
docs/update-contributing-testing-and-publishing-22c6b9dcda9e7982
Draft

docs: update CONTRIBUTING.md testing + publishing sections#76
github-actions[bot] wants to merge 1 commit intomainfrom
docs/update-contributing-testing-and-publishing-22c6b9dcda9e7982

Conversation

@github-actions
Copy link
Copy Markdown
Contributor

Summary

Two stale sections in CONTRIBUTING.md updated after the v0.2.1 release:

  • Testing section: The old text claimed "There is no automated test harness for skills" — but the repo has had a three-tier test suite in tests/ since v0.2.1. Updated to point to tests/README.md, surface the fast tier-2 invariant check (./tests/test-invariants.sh) as a quick pre-PR step, and note that CI runs tier-2 + tier-1 on every PR.

  • Publishing section: The single link README.md#publishing was a dead link — the Publishing section was removed from the README during the v0.2.1 compaction (commit 83bdd43). Replaced with a concrete four-step checklist: bump plugin.json version, update the README status line, create a GitHub Release, and note that marketplace.json auto-tracks main.

Why now

The d688265 commit (fix agent-team manual workflow_dispatch inputs) added new invariant checks in test-invariants.sh. A contributor reading CONTRIBUTING.md after that fix would be told there are no automated tests — and would miss the ./tests/test-invariants.sh step that now catches exactly this class of regression.

Test plan

  • ./tests/test-invariants.sh passes (no stale phrases introduced)
  • All links in the updated sections resolve to real anchors

Generated by Update Docs ·

To install this agentic workflow, run

gh aw add githubnext/agentics/workflows/update-docs.md@96b9d4c39aa22359c0b38265927eadb31dcf4e2a

Two stale sections updated:

Testing: removed the false claim "There is no automated test harness
for skills" — the repo has had a three-tier test suite in tests/ since
v0.2.1. Added a pointer to tests/README.md, surfaced the tier-2
invariant check as a fast pre-PR step, and noted that CI runs tier-2 +
tier-1 on every PR.

Publishing: replaced the broken link to README.md#publishing (the
section was removed during the v0.2.1 README compaction in 83bdd43)
with a concrete four-step checklist: bump plugin.json version, update
README status line, create a GitHub Release, and note that
marketplace.json auto-tracks main.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions github-actions Bot added automation documentation Improvements or additions to documentation labels Apr 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automation documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants