Skill "name" field in SKILL.md ignored. /ce:brainstorm doesn't work, instead requires /compound-engineering:ce-brainstorm

Open
#314 10 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
35/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Stale
Tech stack
typescript

Research direction

Start by reading the skill definitions and invocation documentation mentioned in the issue, then compare their SKILL.md names and directory names with the commands Claude Code recognizes. Reproduce with /ce:brainstorm and the fully qualified command in Claude Code. Done means the documented short command works or the docs consistently describe the supported invocation; the issue leaves the plugin-side versus Claude Code-side fix undecided.

Written by the indexing model from the issue text.

Description

Problem I encountered
Claude Code ignores the name field in SKILL.md frontmatter and registers skills as {plugin-namespace}:{directory-name}. This means the documented invocation syntax isn't working. The docs/README all say: /ce:brainstorm, /ce:review, /ce:work, etc. But what actually works is: /compound-engineering:ce-brainstorm, /compound-engineering:ce-review, /compound-engineering:ce-work.

Reproducing my lil bug:
Step 1. Type /ce:brainstorm and press the enter key.
Step 2. Nothing happens, the skill tool reports the skill isn't recognized.

I think the cause is Every's CE skill's SKILL.md has frontmatter like:
name: ce:brainstorm
But Claude Code resolves skills by plugin-namespace:directory-name, producing compound-engineering:ce-brainstorm. The name field never gets used for resolution.

I thought the plugin was broken for a while :(

Ideas on what might fix it:
Either:
Plugin side: Change name fields to match what Claude Code uses (e.g., compound-engineering:ce-brainstorm), and update docs accordingly
Claude Code side: Support the SKILL.md name field as an alias for skill resolution (may need to be filed with Anthropic, they don't have enough going on so lets knock on their door).
Both: Register a short alias so /ce:brainstorm maps to compound-engineering:ce-brainstorm

My Environment:
Claude Code VSCode extension
Plugin: compound-engineering@every-marketplace v2.43.0 and v2.44.0
OS: Windows 11

Dominant language
TypeScript
Stars
25.6k
Forks
2.1k
Avg merge
3h 57m
Merged PRs (30d)
170

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from EveryInc/compound-engineering-plugin

All issues in EveryInc/compound-engineering-plugin

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.