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).
The 7 sub-skill workflows were git mv'd from the monolith. Their
<required_reading> headers were updated during extraction, but the
export-step prose still pointed at the monolith's export-formate.md,
which does not exist inside the self-contained sub-skills.
Repoint each to the local curated format ref:
- i2s-action-plan -> references/action-plan-format.md
- i2s-discovery -> references/idee-format.md
- i2s-experiment-card -> references/experiment-card-format.md
- i2s-persona -> references/persona-format.md
- i2s-problem-statement -> references/problem-statement-format.md
- i2s-recherche -> references/recherche-report-format.md
Low-risk consistency fix (the correct format was already loaded via
required_reading); removes a dead reference an executing agent would
fail to resolve.
Step 7 of i2s-skill-split refactor. Fourth atomic sub-skill — first
one that uses external tools (WebFetch, WebSearch).
Contents:
- SKILL.md: 6 numbered phases (load + frame questions, show +
stadt-frage, web-research, report, v0.2-vorschlaege, export)
with entry/exit. description includes anti-trigger to
compound-engineering:ce-web-researcher for non-Idea2Self
research.
- workflows/recherche.md: 6-step workflow with two cluster
schemas (Problem / Zielgruppe). git mv from monolith, paths
updated to local refs.
- references/kommunikationsregeln.md: curated extract with
recherche-specific dialog heuristics (no source halluci-
nation, source-conflict-handling, scope-recovery).
- references/recherche-regeln.md: full curated extract -
einfache vs tiefe recherche table, quellen-qualitaet pflichten
(min 2 unabh quellen, primaer > sekundaer, datum-pflicht),
widerspruchs-handling, stadt-spezifische recherche, output-
schema pro frage, anti-patterns.
- references/recherche-report-format.md: curated markdown
schema for ## Recherche-Report sektion with full filled
example.
Tools include WebFetch + WebSearch (the recherche actually
hits the web). Read, Write, Edit, Glob, Grep, AskUserQuestion,
TodoRead, TodoWrite round out the set.
Precondition: ## Problem-Statement + ## Persona both required.
Output: ## Recherche-Report + optional v0.2-updates to PS and
Persona (only on explicit user confirmation).
Philipp Sieder