Skip to content

Commit ba32206

Browse files
committed
docs(architecture): record skills stay markdown, not packages
1 parent 07dd6c4 commit ba32206

1 file changed

Lines changed: 0 additions & 15 deletions

File tree

‎docs/ARCHITECTURE.md‎

Lines changed: 0 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -486,21 +486,6 @@ There is no skill `type` field required for model invocation — a skill body is
486486

487487
Which plugin skill directories are in scope is decided in `runner.ts` / `skillDirsFromEnabledPlugins`, which passes the enabled plugins' dirs to both `discoverSkills` (for the listing) and the `use_skill` tool (for resolution). Project-local `.agents`/`.claude`/`.codex/skills` are always searched. Slash-command registration is first-wins (built-ins, then plugins in discovery order), so a first-party `/implement` stays first-party if a marketplace plugin of the same slash name is also enabled.
488488

489-
#### Decision CL-9805: first-party skills stay SKILL.md, not npm packages
490-
491-
First-party skills remain Markdown capability packages (`SKILL.md`) shipped
492-
in the bundled data-only `corbits-skills` plugin and scoped per director via
493-
`attachedSkills` / `optionalSkills` (CL-9917). They do not become npm packages.
494-
495-
Skills are prompt-time instruction text with no executable code, no build
496-
step, and no versioned API surface, so an npm release and versioning
497-
pipeline would have no consumer. Distribution and trust already ride the
498-
plugin system (repo-origin auto-trust, `defaultEnabled`, the
499-
`corbits-skills` id-collision guard). Director personas stay TypeScript
500-
packages under `src/agent/directors/<id>/`; skill playbooks stay Markdown.
501-
Revisit only if skills gain executable code or a versioned cross-repo
502-
consumer.
503-
504489
## Data Flow
505490

506491
```

0 commit comments

Comments
 (0)