European-Parliament-MCP-Server: Skill for Claude Code

Documentation Standards Skill

Context

This skill applies when:

• Writing or updating README files
• Documenting APIs, functions, or MCP tools
• Creating architecture or design documentation
• Adding JSDoc comments to TypeScript code
• Creating diagrams for system architecture or flows
• Documenting security policies and compliance
• Writing user guides or integration tutorials
• Creating contribution guidelines

Rules

1. Document Security Context: All security-related code must reference ISMS policies in documentation
2. Use JSDoc for Public APIs: All exported functions, classes, and interfaces must have JSDoc comments
3. Include Type Information: JSDoc comments must include @param and @returns with TypeScript types
4. Provide Examples: All public APIs must include code examples showing correct usage
5. Document Exceptions: Use @throws to document all possible exceptions and error conditions
6. Use Mermaid for Diagrams: Create flowcharts, sequence diagrams, and architecture diagrams using Mermaid
7. Keep READMEs Current: Update README.md when adding features, changing setup, or modifying architecture
8. Write for Beginners: Assume readers are unfamiliar with the codebase - explain context and rationale
9. Link to External Docs: Reference official documentation for MCP protocol, European Parliament APIs, and standards
10. Document Decisions: Use Architecture Decision Records (ADRs) for significant technical decisions
11. Security First: Document threat models, security controls, and compliance requirements
12. Show Anti-Patterns: Include examples of incorrect usage to prevent common mistakes
13. Maintain Changelog: Keep CHANGELOG.md updated following Keep a Changelog format
14. Version Documentation: Clearly state which version of the code the documentation applies to
15. Accessibility: Use semantic markdown, descriptive link text, and alt text for images

Examples

✅ Good Pattern: Comprehensive JSDoc for MCP Tool