Skip to content

cat: add skills as first-class catalogue items#884

Draft
DevelopmentCats wants to merge 1 commit intomainfrom
cat/agent-skills-catalogue
Draft

cat: add skills as first-class catalogue items#884
DevelopmentCats wants to merge 1 commit intomainfrom
cat/agent-skills-catalogue

Conversation

@DevelopmentCats
Copy link
Copy Markdown
Collaborator

Summary

Adds agent skills to the registry catalogue alongside modules and templates, following the agentskills.io specification. This enables skills to be discovered and installed via npx skills add https://registry.coder.com once registry-server#442 lands.

Changes

New catalogue entries

  • registry/coder/skills/coder-modules/ with SKILL.md + README.md
  • registry/coder/skills/coder-templates/ with SKILL.md + README.md

Skill bodies are identical to the existing .agents/skills/ versions. Frontmatter adds license, version, author, and tags per the agentskills.io spec.

.agents/skills/ frontmatter updates

Added matching metadata fields (license: Apache-2.0, version: "1.0.0", author: coder, tags) to the existing .agents/skills/ SKILL.md files so they stay in sync with the catalogue versions. No body changes.

CI/CD updates for skills support

  • deploy-registry.yaml: Added registry/**/skills/** to path triggers so skill changes on main trigger redeployment.
  • release.yml: Updated tag extraction to detect whether a tag is for a module or skill and set the changelog path accordingly.
  • version-bump.yaml: Added registry/**/skills/** to path triggers for version-bump label support.
  • version-bump.sh: Updated change detection grep to include skills/ paths.
  • tag_release.sh: Added skills/ to the find scan, added extract_version_from_skill_frontmatter() to read version from SKILL.md frontmatter (since skills don't have Terraform module blocks in README.md).

Related

Implementation plan

See PLAN.md in the branch root for the full plan that guided this implementation.

This PR was created with the help of Coder Agents.

Add agent skills to the registry catalogue alongside modules and
templates, following the agentskills.io specification with proper
frontmatter metadata (license, version, author, tags).

- Add registry/coder/skills/coder-modules/ and
  registry/coder/skills/coder-templates/ as catalogue entries,
  each with SKILL.md (full spec frontmatter + body) and README.md.
- Update .agents/skills/ frontmatter to match catalogue versions.
- Update CI/CD workflows and scripts to support skills:
  - deploy-registry.yaml: add skills path trigger
  - release.yml: detect skills vs modules for changelog path
  - version-bump.yaml: add skills path trigger
  - version-bump.sh: include skills in change detection
  - tag_release.sh: scan skills directories and extract version
    from SKILL.md frontmatter
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant