Skip to content

docs(skills): record decision to keep first-party skills as SKILL.md #1350

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
corbits-triage merged 5 commits into from
Oct 9, 2026
Merged

docs(skills): record decision to keep first-party skills as SKILL.md #1350

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
8429068
docs(skills): record decision to keep first-party skills as SKILL.md
TheGreatAxios Oct 5, 2026
07dd6c4
docs(architecture): record skills stay markdown, not packages
TheGreatAxios Oct 9, 2026
ba32206
docs(architecture): record skills stay markdown, not packages
TheGreatAxios Oct 9, 2026
d287003
docs(architecture): tighten skills stay-markdown wording
TheGreatAxios Oct 9, 2026
fd98d3f
docs(skills): tighten skills-remain-markdown wording
TheGreatAxios Oct 9, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/ARCHITECTURE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -443,7 +443,7 @@ Known keybindings: `Ctrl+C` interrupts the in-flight run, and quits on a second

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

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.
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.

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.

Expand Down
Loading