Pure-XML body structure per marketplace-tools use-xml-tags.md (DEC-0013
D-XML, founder-approved): all markdown headings removed from skill
bodies, replaced with semantic tags (<objective>, <quick_start>,
<success_criteria> required; <essential_principles>, <when_to_use>,
<when_not_to_use>, <precondition_check>, <workflow>, <reference_guides>,
plus router <routing>/<intake>/<file_convention>/<guardrails>). Phases
kept as bold labels inside <workflow>. Frontmatter (name, description,
allowed-tools, metadata.version) preserved; all reference paths intact.
Audit fixes (REV 2026-05-21) folded into the per-skill migration:
- F1 i2s-persona: drop inline-research line (no WebFetch/WebSearch
declared) -> point to i2s-recherche.
- F2 i2s-discovery: web_search -> WebSearch (correct tool name).
- F3 i2s-discovery/experiment-card/prototyp-konzept: document that
WebFetch/WebSearch fire only on explicit confirmation for a single
lookup (full research lives in i2s-recherche).
- F4 router: shorten 897-char description to ~480 (exhaustive trigger
list lives in references/routing-table.md).
- F5 i2s-experiment-card: soften description preconditions (v0.2
preferred, not enforced — matches the actual precondition check).
Verification (8 checks): no markdown headings, 3 required tags/skill,
frontmatter integrity, XML tags balanced (code-fence aware), local refs
resolve, 8 skills, gitignore present, drift-check exit 0. All green.
8 parallel general-purpose subagents (one per SKILL.md, disjoint files).
Close 4 HIGH-priority gaps from router-quality-checklist audit
(agentbrain/memory/templates/router-quality-checklist.md):
1. Quick-Start-Trace (section 3): three end-to-end dialog examples
added before the Routing Pattern section.
- Beispiel A: Happy path (new idea, no file yet)
- Beispiel B: Precondition-Gap (Persona triggered without PS)
- Beispiel C: No-Match (Marketing-Funnel request)
Each example shows phase-by-phase trace + hand-off wording incl.
confirmation question.
2. Phase 1b — No-Match-Handling (section 9): new phase between
intent recognition and precondition check. Explicit out-of-scope
wording, scope-statement, anchor question, and rules against
semantic-fallback routing or hallucinated capabilities.
3. Tiebreaker-Regeln (section 8): added to routing-table.md.
Four-rule hierarchy (Explicit > Semantic; Earlier-pipeline >
Later; Sub-Skill > Router; review-iterate beats any artifact
verb when iteration is explicit). One-question-max with two
options for true ambiguity; otherwise fall through to Phase 1b.
Includes a worked-example table.
4. Guardrails section (section 10): consolidated 8-item "Never X"
block at the end of SKILL.md. Covers no-self-execute, no-silent-
routing-on-missing-precondition, no menu-dump > 8, no halluci-
nated capabilities, no untied tiebreaker routing, no skipped
file-state read, no bypassed user context, no iterated
clarification.
MEDIUM gaps (sections 5/6/7 — bucket grouping, required/optional
precondition split, good/bad output examples) remain open as a
polish pass after step 10b. EVAL strategy (section 11) is a
separate workstream tracked in a future plan.
Files: 117 insertions, 1 deletion across SKILL.md + routing-table.md.
Rewrite SKILL.md to be a pure router per workflow-skill design rules:
- description: trigger conditions only (AP-20). Entry triggers + explicit
anti-triggers naming each i2s-* sub-skill.
- 3 numbered phases (intent / precondition / hand-off) with entry/exit
criteria (AP-6, AP-7).
- Routing pattern with 8 paths: 7 hand-offs to i2s-* sub-skills + 1
cross-cut workflow (review-iterate) kept internal.
- Reference set reduced to router-essentials: routing-table.md (new),
kommunikationsregeln.md, artefakt-pipeline.md.
- Tools narrowed to read/write/edit/glob/grep/ask/todo.
Add references/routing-table.md with trigger -> sub-skill mapping,
precondition rules, hand-off message format, sequence diagram, and
anti-trigger guards.
Vestigial refs (methodik.md, export-formate.md, recherche-regeln.md)
and templates/prototyp-remixer-auswertung.md remain in router for now;
they will be removed in step 10b after sub-skill extraction so any
inter-step git mv preserves rename detection.
Step 3 of i2s-skill-split refactor.
Philipp Sieder