4dcb59d6c0* Add decision log with ADR-lite format (#49) Create docs/decisions.md seeded with 6 historical decisions reconstructed from closed issues and meeting notes. Update CONTRIBUTING.md with guidance on when to add decision log entries and add to README documents table. * Address review feedback: reframe Decision 1 scope, fix relative links
4 KiB
Contributing
How to Participate
This Interest Group welcomes contributions from anyone interested in skills distribution over MCP. You can participate by:
- Joining discussions in the #skills-over-mcp-ig Discord channel (info on joining the Discord server here)
- Opening or commenting on GitHub Discussions in the main MCP repo
- Sharing experimental findings from your own implementations
- Contributing to documentation and pattern evaluation
Communication Channels
| Channel | Purpose | Response Expectation |
|---|---|---|
| Discord #skills-over-mcp-ig | Quick questions, coordination, async discussion | Best effort |
| GitHub Discussions | Meeting notes, long-form technical proposals, experimental findings | Weekly triage |
| This repository | Living reference for approaches, findings, and decisions | Updated after meetings |
Coordination with the Agent Skills Spec
The Agent Skills spec is maintained in the agentskills/agentskills repository. For topics that intersect with both this IG and the Agent Skills spec (e.g., protocol design questions, proposed extensions, or alignment on terminology), the recommended channel is Discussions in that repository.
Before opening a discussion, review the Agent Skills contributing guide.
Meetings
Meeting notes are published in the main MCP repo discussions. Future meetings will be scheduled and scheduling surveys posted in the #skills-over-mcp-ig Discord channel.
Meeting norms:
- Agendas published 24 hours in advance
- Notes published within 48 hours
Decision-Making
As an Interest Group, we operate by rough consensus — we're exploring and recommending, not deciding. Outputs include:
- Documented requirements and use cases
- Evaluated approaches with findings
- Recommendations to relevant WGs or as SEP proposals
Contribution Guidelines
Documenting Approaches and Findings
When adding experimental findings or new approaches:
- Include enough detail for others to reproduce or evaluate
- Note which clients and servers were tested
- Be explicit about what worked, what didn't, and what remains untested
- Attribute community input with GitHub handles and link to the source where possible
Community Input
When adding quotes or input from community discussions:
- Attribute to the contributor by name and GitHub handle
- Link to the original source (Discord thread, GitHub comment, etc.) where possible
- Present input as blockquotes to distinguish it from editorial content
Decision Log
Significant decisions made during meetings or through async discussion should be recorded in docs/decisions.md using the ADR-lite format defined there. A decision is worth logging when it:
- Chooses one approach over alternatives
- Sets or changes the group's scope
- Establishes a convention or coordination mechanism
Add a new entry after the meeting where the decision was made or when rough consensus is reached asynchronously. Include context, the decision itself, rationale, and links to relevant issues, PRs, or discussion threads.
Filing Issues
Use GitHub Issues for:
- Proposing new approaches or use cases
- Reporting gaps in documentation
- Tracking action items from meetings