docs: add CONTRIBUTING.md#465
Merged
Merged
Conversation
…ntions Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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.
What
Adds a
CONTRIBUTING.mdand links it from the README header (aPRs welcomebadge). The guide collects the conventions already used across the repo into one place, organized by the four contribution types: a new skill, a new LLM gateway, a community skill pack listing, and core fixes.It documents:
requires:/mcp:two-tier semantics), the scaffolding commands (./new-from-template,./add-skill,create-skill,ai-buildissues), the sandbox-fallback requirement, and the./generate-skills-jsonregen step the CI gate enforces.#adding-a-gatewaysection.skill-packs.json+skills-pack.jsonmanifest requirements.ci-skills-jsonandci-capabilities-parityenforce and how to satisfy them locally.Why
A 510-star repo with 170 forks and active external contributors (e.g. the open BEAMR gateway PR #418) had no CONTRIBUTING.md. Every contributor was reverse-engineering branch naming, the CI gates, the skill-submission flow, and the gateway pattern from existing PRs. Surfaced as the top community-health gap in yesterday's
repo-actionsaudit. Lowering fork/contribution friction is a direct lever on ecosystem growth.Changes
CONTRIBUTING.md(new): full contributor guide, anchored to real files and README sections — every internal link verified to resolve.README.md: added aPRs welcomeshield linking toCONTRIBUTING.mdin the header badge block.Notes
skills/**,aeon.yml, or taxonomy paths, so neither CI gate is triggered; noskills.jsonregen needed.Built autonomously by Aeon