Skip to content

Commit db74e5b

Browse files
Merge pull request #1350 from corbitsdev/cl-9805-skills-stay-markdown-not-packages
docs(skills): record decision to keep first-party skills as SKILL.md
2 parents 19d59bb + fd98d3f commit db74e5b

1 file changed

Lines changed: 1 addition & 1 deletion

File tree

‎docs/ARCHITECTURE.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -443,7 +443,7 @@ Known keybindings: `Ctrl+C` interrupts the in-flight run, and quits on a second
443443

444444
### Skills (`src/extensions/skills.ts`)
445445

446-
Skills are Markdown capability packages (`SKILL.md`). Each skill is a **dual surface**: the model looks up descriptions with the advertised `skill_search` catalog tool, loads a body on demand via the `use_skill` core tool, and the operator can invoke it as `/<skill-name>` unless frontmatter sets `user-invocable: false`. The primary prompt lists names only. `loadSkillCommands` (`src/plugins/skill-commands.ts`) synthesizes a slash command that sends the SKILL.md body (plus typed args) to the primary session; untagged skills still become slashes.
446+
Skills stay Markdown content, not packages — they are capability packages (`SKILL.md`). Each skill is a **dual surface**: the model looks up descriptions with the advertised `skill_search` catalog tool, loads a body on demand via the `use_skill` core tool, and the operator can invoke it as `/<skill-name>` unless frontmatter sets `user-invocable: false`. The primary prompt lists names only. `loadSkillCommands` (`src/plugins/skill-commands.ts`) synthesizes a slash command that sends the SKILL.md body (plus typed args) to the primary session; untagged skills still become slashes.
447447

448448
Corbits Code **ships a bundled catalog** as the first-party data-only plugin `plugins/corbits-skills/` (id `corbits-skills`, kind `command`, `defaultEnabled: true`). Origin `repo` is auto-trusted. Auto-**enable** applies only when `origin === "repo"` AND `manifest.defaultEnabled` is true AND `settings.plugins[id]` is missing; an explicit `enabled: false` still disables. Marketplace (user / project / path / claude) `defaultEnabled` is ignored — those plugins stay opt-in. The id is `corbits-skills` (not `gaas`) so a later marketplace plugin cannot replace the module by id collision.
449449

0 commit comments

Comments
 (0)