Idea2Self/agent-skills
2
0
Fork 0
Code Activity
Files
main
agent-skills/skills/i2s-discovery/SKILL.md
T
Philipp Sieder 7691b408e8 refactor(skills): migrate all 8 SKILL.md to pure-XML + apply audit fixes 
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).
2026-05-22 09:47:54 +02:00

7.0 KiB
Raw Permalink Blame History

name, description, allowed-tools, metadata
name description allowed-tools metadata
i2s-discovery Idea2Self Discovery-Interview. Strukturiert eine vage Idee in einem 5-Schritt-Interview (Orientierung, Vertiefung adaptiv nach Ideen-Typ, Widerspruchspruefung, Bestaetigung, Datei-Bootstrap). Loest aus bei 'Discovery-Interview', 'vage Idee strukturieren', 'Idee erfassen', 'neue Idee starten' (wenn aus Router-Hand-off oder direkt), 'meine Idee in eine Datei bringen', 'idea2self-Datei anlegen', 'Idee in Struktur giessen'. NICHT aktivieren bei: 'Idea2Self starten / Sprint / Coaching' (dafuer klarheit-mit-idea2self Router), 'Problem-Statement erstellen' (dafuer i2s-problem-statement), 'Persona erstellen' (i2s-persona), oder wenn bereits eine idea2self-Datei mit ## Idee existiert und der Nutzer iterieren will (dafuer klarheit-mit-idea2self review-iterate). Output: ## Idee Sektion in neuer idea2self-<kurztitel>.md Datei. Sprache: Deutsch. Read Write Edit Glob Grep AskUserQuestion WebFetch WebSearch TodoRead TodoWrite
version
1.0.0
Erster Schritt im Idea2Self-Prozess. Fuehrt den Nutzer durch ein adaptives 5-Schritt-Interview, das eine vage Idee in eine strukturierte Idee + persoenliche Passung + Scope-Ausschluss verwandelt. Legt am Ende die zentrale `idea2self-.md` Datei an.

<essential_principles>

  1. Adaptiv nach Ideen-Typ. Nach 2-3 Orientierungs-Fragen klassifizieren (Produkt / Wissen / Community / Content / Physisches / unklar). Folgefragen sind typ-spezifisch — generische Fragenliste ist Sediment.
  2. Persoenliche Passung ist Pflicht. "Warum ich?" — ohne Verbindung zwischen Idee und Founder-Staerken/-Motivation bleibt die Datei tot. Wenn Nutzer ausweicht: konkrete Sub-Frage stellen ("Wer in deinem Netzwerk hat das Problem konkret?").
  3. Scope-Ausschluss vor Bestaetigung. "Was wird bewusst NICHT gebaut?" gehoert in Schritt 2, nicht nachgelagert. Ohne Ausschluss bleibt der Scope diffus und der Action-Plan spaeter unmoeglich.
  4. Widerspruch wird benannt, nicht ignoriert. "Einfach UND umfassend", "alle als Zielgruppe", "Loesung ohne Problem" — explizit thematisieren in Schritt 3. Optionen anbieten statt nachsichtig sein.
  5. Inline-Recherche moeglich, aber nicht Default. Bei Wissensluecke des Nutzers: anbieten ("Soll ich kurz recherchieren?"). Erst auf Bestaetigung WebSearch nutzen. Ergebnisse als _(Recherche)_ markieren. </essential_principles>

<when_to_use>

  • Nutzer hat eine noch nicht strukturierte Idee und will sie in Form bringen.
  • Aus Router-Hand-off (Pfad 1 in klarheit-mit-idea2self/references/routing-table.md).
  • Direkter Trigger: "Discovery-Interview", "vage Idee strukturieren", "Idee erfassen", "idea2self-Datei anlegen". </when_to_use>

<when_not_to_use>

  • Es gibt bereits eine idea2self-<idee>.md mit ausgefuellter ## Idee Sektion -> Router review-iterate oder direkter Sub-Skill je nach Iterations-Ziel.
  • Nutzer will direkt zum Problem-Statement -> i2s-problem-statement (wenn Idee bereits klar genug fuer HMW-Formulierung).
  • Generelles Idee-Brainstorming ohne Validierungsabsicht -> compound-engineering:ce-brainstorm. </when_not_to_use>

<quick_start> Trigger "Discovery-Interview starten" oder "vage Idee strukturieren", keine Vorbedingung noetig. Entry-Point ist Phase 1 (Orientierung); danach laeuft das 5-Schritt-Interview durch bis Phase 5. Output: eine neue idea2self-<kurztitel>.md Datei mit ausgefuellter ## Idee Sektion. Detaillierte Referenzen siehe Reference-Index unten. </quick_start>

**Phase 1 — Orientierung**

Entry: Skill aktiviert.

Aktionen:

  1. Stelle 3 Orientierungs-Fragen (siehe workflows/discovery.md Schritt 1).
  2. Aus den Antworten den Ideen-Typ ableiten.
  3. Typ explizit zurueckspiegeln: "Klingt nach einer/m [Typ]-Idee. Korrekt?"

Exit: Ideen-Typ ist bestaetigt.

Phase 2 — Vertiefung (adaptiv)

Entry: Ideen-Typ bestaetigt.

Aktionen:

  1. Lade die typ-relevanten Kategorien aus workflows/discovery.md Schritt 2 (4 Kategorien: Problem/Motivation, Zielgruppe, Kontext/Ressourcen, Scope/Abgrenzung).
  2. Stelle pro Kategorie 1-2 Fragen, max 4-6 insgesamt.
  3. Bei Wissensluecke des Nutzers: Inline-Recherche anbieten (WebSearch). Web-Tools (WebSearch/WebFetch) werden NUR auf explizite Nutzer-Bestaetigung und nur fuer eine einzelne Begriffsklaerung aktiviert — fuer volle Recherche an i2s-recherche verweisen.
  4. Pflicht-Frage am Ende von Phase 2: "Was wird bewusst NICHT dazugehoeren?"

Exit: Alle 4 Kategorien beruehrt + Scope-Ausschluss benannt.

Phase 3 — Widerspruchspruefung

Entry: Phase 2 abgeschlossen.

Aktionen:

  1. Pruefe Antworten gegen die 4 typischen Konflikte (workflows/discovery.md Schritt 3).
  2. Bei Konflikt: benennen, Optionen geben, Nutzer-Entscheidung einholen.
  3. Bei keinem Konflikt: explizit "Keine inneren Widersprueche erkannt" sagen.

Exit: Konflikte sind geloest oder als offen markiert.

Phase 4 — Bestaetigung

Entry: Phase 3 abgeschlossen.

Aktionen:

  1. Verstaendnis zusammenfassen ("Du willst [X] fuer [Zielgruppe] bauen, weil [Motivation]. Kernproblem: [P]. Ressourcen: [R]. Ausschluss: [A]. Stimmt das?").
  2. Auf Bestaetigung warten. Bei Korrektur: Phase 2 punktuell zurueckspringen.

Exit: Nutzer bestaetigt das zusammengefasste Verstaendnis.

Phase 5 — Datei-Bootstrap

Entry: Bestaetigung erhalten.

Aktionen:

  1. Kurztitel ableiten (3-5 Woerter, kebab-case).
  2. idea2self-<kurztitel>.md aus templates/idea2self-vorlage.md anlegen.
  3. ## Idee Sektion nach references/idee-format.md ausfuellen.
  4. Restliche Sektionen als leere Platzhalter einsetzen.
  5. ## Changelog mit erstem Eintrag (Datum + "Datei angelegt").
  6. Datei dem Nutzer zeigen + Hand-off-Hinweis: "Naechster Schritt: Problem-Statement. Trigger: 'Problem-Statement erstellen' fuer i2s-problem-statement."

Exit: Datei existiert auf Disk, ## Idee ist ausgefuellt, Hand-off ausgesprochen.

<reference_guides> Kommunikation: references/kommunikationsregeln.md (Tonalitaet, Marker, Steuerbefehle). Datei-Format: references/idee-format.md (Schema fuer ## Idee Sektion). Datei-Skelett: templates/idea2self-vorlage.md. Workflow-Detail (alle 5 Schritte): workflows/discovery.md.

File Purpose
workflows/discovery.md Vollstaendiger 5-Schritt-Interview-Ablauf mit Fragen
references/kommunikationsregeln.md Tonalitaet, Marker (Vorschlag/Annahme), Steuerbefehle
references/idee-format.md Markdown-Schema fuer die ## Idee Sektion
templates/idea2self-vorlage.md Skelett der idea2self-Datei (wird in Phase 5 angelegt)
</reference_guides>

<success_criteria>

  • Ideen-Typ ist klassifiziert + bestaetigt.
  • Idee ist in 1-2 Saetzen beschreibbar.
  • Zielgruppe ist benannt (vage erlaubt, aber konkrete Person als Anker).
  • Problem ist identifiziert.
  • Persoenliche Motivation + Ressourcen (Stunden/Woche) sind klar.
  • Scope-Ausschluss ist definiert.
  • Innere Widersprueche sind benannt oder geloest.
  • idea2self-<kurztitel>.md existiert mit ## Idee Sektion + ## Changelog.
  • Hand-off zu i2s-problem-statement ist ausgesprochen. </success_criteria>
View Git Blame Copy Permalink