feat: align all skills with agentskills.io specification#163
Conversation
Closes #10 - Fix 8 skills with non-standard frontmatter fields (argument-hint, author, version) by moving them to spec-compliant metadata: map - Add Related Skills sections to all 31 skills with name-based cross-references (never file paths) - Create .github/skills/ directory with symlinks to all 31 skills for Copilot-compatible discovery alongside vendor-specific paths - Add validate-skills.yml GitHub Action running agentskills validate, progressive disclosure limit checks, and symlink verification All 31 skills pass agentskills validate (skills-ref v0.1.1). (claude)
Summary of ChangesHello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed! This pull request focuses on improving the structure, validation, and discoverability of skills within the repository. It standardizes skill metadata, enhances skill relationships, and introduces tooling for continuous validation, while also improving Copilot compatibility. Highlights
Ignored Files
Using Gemini Code AssistThe full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips. Invoking Gemini You can request assistance from Gemini at any point by creating a comment using either
Customization To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a Limitations & Feedback Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here. Footnotes
|
Adds .pre-commit-config.yaml with: - Base hygiene hooks (YAML, JSON, whitespace, EOL, merge conflicts) - Markdown linting (markdownlint-cli2 v0.20.0) - Spell checking (cspell v9.6.0) - Commit message validation (commitlint v9.24.0 + commit-check v2.4.1) - File size enforcement (10KB max) - Agent skills validation (agentskills.io spec via local hook) Also adds .commitlintrc.yaml matching the .github repo convention with breaking change marker blocking and custom type list. (claude)
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
Auto-loaded rule ensuring all skills pass agentskills validate and follow the agentskills.io specification. (claude)
1 participant
Summary
argument-hint,author,version) by moving them to the spec-compliantmetadata:map.github/skills/directory with symlinks for Copilot-compatible discoveryvalidate-skills.ymlGitHub Action for continuous spec validation.pre-commit-config.yamlwith foundation hooks (commitlint, cspell, markdownlint, YAML lint, secrets detection)Closes #10
Changes
Frontmatter fixes (8 skills):
rebase-pr: movedversionto metadatafinalize-pr,squash-merge-pr,trigger-ai-reviews,resolve-pr-threads: movedargument-hintto metadatacodeql-permission-classification,github-workflow-security-patterns: movedauthor,versionto metadatatoken-breakdown: movedauthor,versionto metadataRelated Skills sections: Added to all 31 skills across 12 plugins
Directory structure:
.github/skills/with 31 symlinks to vendor-specific plugin locations (Option A from issue — vendor-specific paths stay, symlinks for Copilot)Validation tooling: New
validate-skills.ymlworkflow with:agentskills validateon all skills (skills-ref v0.1.1).github/skills/symlink integrity verificationPre-commit hooks: New
.pre-commit-config.yamlmatching .github foundation template with:cspell dictionary: Added
agentskillsandcommitlintrcto known wordsTest Plan
agentskills validate(0 failures).github/skills/resolve correctlyagentskills validate .github/skills/finalize-pr)🤖 Generated with Claude Code