Skip to content

docs: add Kennis (knowledge) skill type to create-skill conventions#47

Open
oinkspook wants to merge 1 commit into
mainfrom
skills/create-skill-knowledge-type
Open

docs: add Kennis (knowledge) skill type to create-skill conventions#47
oinkspook wants to merge 1 commit into
mainfrom
skills/create-skill-knowledge-type

Conversation

@oinkspook

Copy link
Copy Markdown

Pull Request Description

Type of Change

  • Documentation update

Description of Changes

Voegt een Kennis-skilltype toe aan de create-skill-conventies.

Uit de review van Steven op #42 kwam naar voren dat niet elke skill een ## Workflow met "When the user invokes /naam:" past. Skills komen op twee manieren binnen: expliciet (/naam) óf impliciet — Claude laadt de body automatisch o.b.v. de description zodra je vraag matcht. Dat splitst skills in:

  • Workflow-skills (Actie/Review/Generatie/Wizard) — een procedure die je uitvoert## Workflow.
  • Kennis-skills — conventies/feiten die Claude's volgende actie goed maken, meestal impliciet getriggerd (bijv. een Flux-error plakken → juiste fix) → ## When this applies i.p.v. ## Workflow.

Concreet toegevoegd aan create-skill/SKILL.md:

  1. Een Kennis-rij in de classificatietabel (stap 3).
  2. Uitleg van het workflow-vs-kennis-onderscheid.
  3. Een structuur-variant voor kennis-skills (stap 4) met ## When this applies; ## Important blijft verplicht.

Comparison: Before and After

Before:

create-skill kende alleen workflow-vormige types; alle skills kregen ## Workflow.

After:

Kennis-skills hebben een eigen, eerlijke vorm — wat de recent toegevoegde skills (helm, docker, gitlab-ci, sram-oidc, …) al volgen.

Related Issues

Vervolg op de conventie-alignment in #42, #43, #46.

Testing Instructions

  • Lees create-skill/SKILL.md: de Kennis-rij + structuur-variant renderen correct.
  • Puur documentatie; geen code.

Dependencies

Geen.

Checklist

  • My code follows the project's coding standards
  • I have updated the documentation accordingly

Documenteert het onderscheid tussen workflow-skills (Actie/Review/Generatie/Wizard) en kennis-skills:

- Nieuwe 'Kennis'-rij in de classificatietabel
- Uitleg dat kennis-skills meestal impliciet geladen worden o.b.v. de description
- Structuur-variant met ## When this applies i.p.v. ## Workflow (## Important blijft verplicht)

Vervolg op de review van Steven op #42, waar dit onderscheid naar voren kwam.

Co-Authored-By: Claude <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants