feat: add modules and templates skills#2
Merged
Conversation
Adds two new skills under skills/coder namespace: - modules: helps agents add or update Coder modules (registry.coder.com/modules) inside an existing Coder template. - templates: helps agents author, edit, push, and version Coder templates. Each skill mirrors the setup skill's structure: SKILL.md with frontmatter and a workflow, plus an agents/openai.yaml metadata file for the Codex plugin manifest. The skill slugs are 'modules' and 'templates' to match the existing 'setup' convention (full IDs are coder/modules, coder/templates, and coder/setup). Display names are 'Coder Modules' and 'Coder Templates'. Both skills delegate detail to upstream coder.com/docs and to each module's or template's README on registry.coder.com, keeping the SKILL.md content focused on integration workflow rather than copying upstream reference material.
There was a problem hiding this comment.
Pull request overview
Adds two new Coder skills (modules and templates) under skills/ to complement the existing setup skill, providing agent workflows for integrating registry modules into templates and for authoring/updating templates end-to-end.
Changes:
- Added
skills/modules/SKILL.md+skills/modules/agents/openai.yamlto guide adding/updating Coder registry modules inside an existing template. - Added
skills/templates/SKILL.md+skills/templates/agents/openai.yamlto guide scaffolding/editing/pushing/versioning Coder templates.
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.
| File | Description |
|---|---|
| skills/templates/SKILL.md | New workflow and guardrails for scaffolding and maintaining Coder templates. |
| skills/templates/agents/openai.yaml | New skill metadata for Codex/OpenAI agent manifest (needs alignment with existing manifest structure). |
| skills/modules/SKILL.md | New workflow and guardrails for integrating Coder registry modules into an existing template. |
| skills/modules/agents/openai.yaml | New skill metadata for Codex/OpenAI agent manifest (needs alignment with existing manifest structure). |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
- Add top-level interface: key to agents/openai.yaml on both new skills, matching the existing setup skill's manifest shape. - Add per-skill assets/icon.png and assets/logo.png so icon paths resolve to skills/<slug>/assets/* like the setup skill, instead of pointing outside the skill root. - Tighten the push section in skills/modules/SKILL.md to match skills/templates/SKILL.md: pass --yes to coder templates push and verify with coder templates versions list rather than coder templates list.
Per review feedback, the per-skill assets/ directories were redundant copies of /assets/icon.png and /assets/logo.png at the repo root. Drop the duplicates and point both manifests at the existing root copies via ../../assets/icon.png and ../../assets/logo.png. The setup skill keeps its own copies for now; cleaning that up is a separate change.
DevelopmentCats
added a commit
to coder/registry
that referenced
this pull request
May 26, 2026
) ## Summary Adds two new catalogue entries to `registry/coder/skills/README.md`: - `coder/modules` with `coder-modules.svg` - `coder/templates` with `coder-templates.svg` Both pull from `coder/skills@main` alongside the existing `setup` skill. Tag sets are scoped so the registry-server filter facets pick them up (`[coder, terraform, modules]` and `[coder, terraform, templates]`). ## Verified locally ``` go run ./cmd/readmevalidation processing skills README files num_files=1 processed all skills README files num_files=1 ``` No other validator output changed (23 contributor profiles, 79 modules, 33 templates still parse cleanly). ## Source repo content The skill content (SKILL.md plus per-skill metadata) lives in coder/skills#2. Until that PR merges, this catalogue change is effectively a no-op: the registry-server build pipeline iterates over skills it discovers in the source repo, and looks up catalogue overrides per skill. Catalogue entries for skills that do not yet exist in the source repo are silently ignored. That means these two PRs can land in either order without breaking anything. Both have to be merged before the new skills appear on registry.coder.com. ## Related - coder/skills#2 (source repo content for `modules` and `templates`) - coder/registry-server#442 (build pipeline, API, MCP, frontend) - #884 (catalogue format) This PR was created with help from Coder Agents.
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
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
Adds two new skills alongside the existing
setupskill:modules: helps agents add or update Coder modules (from registry.coder.com/modules) inside an existing Coder template.templates: helps agents scaffold, edit, push, and version Coder templates.Both follow the same shape as
setup: SKILL.md with workflow plus anagents/openai.yamlmetadata file for the Codex plugin manifest.Naming
The registry has reserved
.icons/coder-modules.svgand.icons/coder-templates.svg, so the catalogue side is anticipated. The skill slugs themselves aremodulesandtemplates, matching the existingsetupconvention. Full IDs end up ascoder/modulesandcoder/templates. Display names areCoder ModulesandCoder Templates.If you'd rather have the slugs themselves be
coder-modulesandcoder-templates, say so and I'll rename.Content scope
Each SKILL.md keeps the same opinions as
setup:coder_agent, secrets in tfvars, blind--activatepushes).Descriptions are 514 chars (
modules) and 536 chars (templates), well under the 1024-char Codex cap enforced byscripts/lint.sh.Verified locally
The existing test harness (
test/claude.sh,test/codex.sh) is wired to thesetupskill specifically and is not extended here. New tests formodulesandtemplateswould need their own harness fixtures; happy to follow up if you want them.Related
registry/coder/skills/README.mdso they appear at registry.coder.com.This PR was created with help from Coder Agents.