Update contribution guidelines and docs for multi-tool repo - #76
Open
udid-aws wants to merge 1 commit into
Open
Conversation
- Rework CONTRIBUTING.md: general + tool-specific guidelines (skills, custom agents, MCP servers), testing methodology, and PR flow - Add MCP servers section to README and broaden the concepts heading - Reframe convention docs (CLAUDE.md, project-conventions.md) from skills-only to skills + custom agents + MCP servers: updated intro, key references, repository structure, and new Writing Custom Agents / Writing MCP Servers sections; scope extension/zip rules to skills - Rewrite llms.txt to cover all three tool types with catalog sections for custom agents and MCP servers - Replace Agent Skill Eval references with the internal skill evaluation tool across docs, llms.txt, and PR template
kavix
approved these changes
Sep 9, 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
2 participants
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.
Summary
Updates the contribution guidelines and supporting docs to reflect that this repository now hosts three tool types — skills, custom agents, and MCP servers — not just skills. Also swaps references to the public Agent Skill Eval framework for our DevOps Agent skill evaluation tool (purpose-built for evaluating DevOps Agent skills, and still internal).
Changes
Testing
Docs-only change. Verified internal links and relative paths, confirmed catalog entries match the actual
skills/,custom-agents/, andmcp/directories, and checked that no stray "Agent Skill Eval" references remain in the updated files.Notes
.skilleval.yamlfrom individual skill directories/READMEs is intentionally left for a separate follow-up pass.License confirmation