Communitygithub.com

curiositech/windags-skills

Fängt Prompts automatisch ab und optimiert sie mit dem prompt-learning MCP-Server. Lernfähig durch performancebasierte, embedding-indexierte Historie. Nutzt APE-, OPRO- und DSPy-Muster.

Was ist windags-skills?

Dieses Skill dient der automatischen, zustandsbehafteten Optimierung von Prompts, insbesondere für komplexe Aufgaben. Es analysiert eingehende Anfragen und wählt abhängig von Token-Budget, Aufgabentyp und Optimierungsbedarf eine geeignete Technik: APE (Automatic Prompt Engineer) für reine Umformulierungen, OPRO (Optimization by PROmpting) für parametertuning unter Nebenbedingungen oder DSPy-Kompilation für mehrstufige Pipelines. Die Entscheidungsfindung basiert auf einem klar strukturierten Entscheidungsbaum, der unter anderem die Aufgabenkomplexität, historische Embedding-Retrieval und verfügbare Token-Reserven berücksichtigt. Das Skill vermeidet Überoptimierung durch Abbruchkriterien wie „Verbesserung < 1% über drei Runden“ oder das Erreichen einer Qualitätsschwelle von 0,95. Es ist in Agentenplattformen wie Claude Code, Cursor und Codex integrierbar, benötigt aber zwingend den prompt-learning MCP-Server. Die README beschreibt ausführlich Entscheidungspunkte, Optimierungsmuster, Qualitätsprüfungen und Fehlermodi wie die „Überoptimierungsspirale“ oder historisches Overfitting. Anwendungsbeispiele demonstrieren die Optimierung vager Code-Optimierungsanfragen, Entscheidungsvorlagen und technischer Aufgaben. Wichtig: Für einfache Fragen wird das Skill übersprungen – der Agent antwortet direkt. Es ist nicht für Dateioperationen, direkte Befehle oder kreatives Schreiben gedacht.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/curiositech/windags-skills/tree/HEAD/skills/automatic-stateful-prompt-improver

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Automatischer zustandsbehafteter Prompt-Verbesserer

Entscheidungspunkte

PROMPT-BEWERTUNG:
├── Einfache Frage / einfacher Befehl (was, wann, wie)
│   └── Optimierung überspringen → Direkt antworten
├── Komplexe Aufgabe (mehrschrittig, begründend, technisch)
│   ├── Token-Budget < 1000
│   │   └── APE: 3-5 Iterationen
│   ├── Token-Budget 1000-5000
│   │   └── OPRO: 5-10 Iterationen
│   └── Token-Budget > 5000
│       └── DSPy-Kompilation: 10-20 Iterationen
└── Wiederverwendbare Vorlage / System-Prompt
    └── Vollständige Optimierung mit historischem Retrieval

OPTIMIERUNGSTECHNIK-AUSWAHL:
├── Anweisungsumschreibung erforderlich
│   └── APE verwenden (Automatic Prompt Engineer)
├── Parametertuning mit Nebenbedingungen
│   └── OPRO verwenden (Optimization by PROmpting)
├── Komplexe Pipeline mit mehreren Modulen
│   └── DSPy-Kompilationsmuster verwenden
└── Unbekannter / explorativer Bereich
    └── Hybrid APE→OPRO→DSPy-Kaskade

ITERATIONSKONTROLLE:
├── Verbesserung < 1% für 3 Runden → STOPP
├── Qualitätspunktzahl > 0,95 → STOPP
├── Maximale Iterationen erreicht → STOPP
├── Benutzerzufriedenheit bestätigt → STOPP
└── Fortfahren → Nächste Iteration

RÜCKMELDUNGSINTEGRATION:
├── Aufgabe erfolgreich (Benutzer bestätigt / Metriken gut)
│   └── Positives Feedback aufzeichnen + für Retrieval einbetten
├── Aufgabe fehlgeschlagen / schlechte Qualität
│   └── Negatives Feedback aufzeichnen + Fehlermodus analysieren
└── Unklares Ergebnis
    └── Benutzer vor der Aufzeichnung um explizites Feedback bitten

Fehlermodi

Überoptimierungsspirale

  • SYMPTOM: Prompt wächst auf 500+ Token mit vielen verschachtelten Einschränkungen
  • DIAGNOSE: Jagd auf abnehmende Grenzerträge anstatt bei „gut genug“ zu stoppen
  • BEHEBUNG: 80/20-Regel anwenden – wenn die Verbesserung pro Iteration unter 5 % fällt, anhalten

Vorlagenbesessenheit

  • SYMPTOM: Iterationen werden mit Formatierung/Struktur statt mit Aufgabenklarheit verbracht
  • DIAGNOSE: Verwechslung von Präsentation mit Leistung
  • BEHEBUNG: Tatsächlichen Aufgabenerfolg messen, nicht Vorlagenkonformität

Historische Überanpassung

  • SYMPTOM: Optimierter Prompt funktioniert für frühere Beispiele, versagt aber bei neuen Eingaben
  • DIAGNOSE: Training auf einem zu schmalen Datensatz aus dem Retrieval
  • BEHEBUNG: Vielfältige Beispiele in die Optimierung einbeziehen, an zurückgehaltenen Fällen testen

Fehleinschätzung der Fähigkeiten

  • SYMPTOM: Umfangreiches Gerüst für Aufgaben, die das Modell nativ beherrscht
  • DIAGNOSE: Annahme von Modellgrenzen ohne Test
  • BEHEBUNG: Basis-Fähigkeit vor aufwändigem Prompting testen

Messblindheit

  • SYMPTOM: Mehrere Iterationen ohne klare Erfolgsmetriken
  • DIAGNOSE: Optimieren, ohne zu wissen, was „besser“ bedeutet
  • BEHEBUNG: Im ersten Schritt messbare Erfolgskriterien definieren

Ausgearbeitete Beispiele

Beispiel 1: Code-Optimierungsanfrage

Original: „Mach diesen Code besser“

def process_data(data):
    results = []
    for item in data:
        if item > 0:
            results.append(item * 2)
    return results

Entscheidungspunkte durchlaufen:

  1. Bewertung: Komplexe Aufgabe (erfordert Code-Analyse) → Optimierung auslösen
  2. Technikauswahl: Code-Review + Verbesserung → APE mit 5 Iterationen
  3. Abgerufener Kontext: Ähnliche Code-Optimierungs-Prompts aus der Historie
  4. Optimierter Prompt: „Analysiere diese Python-Funktion hinsichtlich Performanz, Lesbarkeit und pythonischer Muster. Identifiziere spezifische Verbesserungen: algorithmische Komplexität, Speichernutzung, Randfälle und Stil. Liefere den refaktorierten Code mit Erklärungen.“

Was ein Anfänger übersieht: Vages „besser“ legt keine Kriterien fest Was ein Experte erkennt: Explizite Dimensionen (Performanz, Stil, Randfälle) sind nötig

Ergebnis: Klare Analyse zur List-Comprehension-Möglichkeit, Randfallbehandlung, Typannotationen

Beispiel 2: Denkaufgaben-Vorlage

Original: „Hilf mir, diese Entscheidung zu durchdenken“

Entscheidungspunkte durchlaufen:

  1. Bewertung: Wiederverwendbare Vorlage + Denkaufgabe → Vollständige Optimierung
  2. Historisches Retrieval: Entscheidungsrahmen-Prompts gefunden (0,87 Ähnlichkeit)
  3. Technikauswahl: DSPy-Kompilation (strukturierte Denk-Pipeline)
  4. Iterationsstrategie: 10 Runden, Messung der Entscheidungsqualität

Optimierte Vorlage:

Entscheidungsanalyse-Rahmen:
1. SITUATION: Die Entscheidung klar mit Randbedingungen darlegen
2. BETEILIGTE: Betroffene Parteien und deren Interessen auflisten
3. OPTIONEN: 3-5 verschiedene Alternativen generieren
4. KRITERIEN: Erfolgsmetriken und Gewichtung definieren
5. ABWÄGUNGEN: Jede Option gegen die Kriterien analysieren
6. EMPFEHLUNG: Beste Option mit Konfidenzniveau auswählen

Angewendete Qualitätsprüfungen: Vorlagenvollständigkeit, Wiederverwendbarkeitspunktzahl, Benutzerzufriedenheit

Beispiel 3: Mehrdeutige technische Anfrage

Original: „Monitoring einrichten“

Entscheidungspunkte durchlaufen:

  1. Bewertung: Unterspezifiziert + technisch → Optimierung auslösen
  2. Klärungsstrategie: OPRO mit Erhebung von Randbedingungen
  3. Bereichskontext: Abgerufene Monitoring-Einrichtungsmuster

Optimierter Prompt: „Monitoring-Setup entwerfen durch Angabe von: (1) Infrastrukturumfang (Server, Container, Anwendungen), (2) Schlüsselmetriken (Performanz, Verfügbarkeit, Geschäftskennzahlen), (3) Alarmgrenzwerte und Eskalation, (4) Technologie-Stack-Einschränkungen, (5) Budget-/Komplexitätsgrenzen. Umsetzungsfahrplan mit Prioritäten bereitstellen.“

Vorher/Nachher-Abwägungen:

  • Vorher: Endloses Hin-und-Her zur Klärung
  • Nachher: Strukturierte Anforderungserhebung in einem einzigen Austausch
  • Kosten: Längerer initialer Prompt
  • Nutzen: Vollständige Spezifikation in einer Runde

Qualitätsprüfungen

Checkliste vor dem Aufruf von optimize_prompt:

  • Aufgabenkomplexität > 3 (mehrschrittig / Begründung erforderlich)
  • Klare Erfolgskriterien definiert oder ableitbar
  • Token-Budget geschätzt und Technik ausgewählt
  • Bereichskontext für das Retrieval identifiziert
  • Iterationslimit basierend auf Komplexität gesetzt

Validierung nach der Optimierung:

  • Optimierter Prompt ist spezifisch und handlungsorientiert
  • Erfolgsmetriken sind messbar
  • Konsistenz der Randbedingungen verifiziert (keine Widersprüche)
  • Tokeneffizienz: Verbesserung rechtfertigt die zusätzliche Länge
  • Historischer Kontext angemessen integriert
  • Benutzerbestätigung für größere Änderungen eingeholt

Qualitätsbewertungsschema (0-100):

  • Klarheit: Kann ein naiver Benutzer die Anforderungen verstehen? (25 Punkte)
  • Spezifität: Konkrete vs. abstrakte Anweisungen? (25 Punkte)
  • Vollständigkeit: Deckt Randfälle und Randbedingungen ab? (25 Punkte)
  • Effizienz: Erreicht Ziele ohne Aufblähung? (25 Punkte)

Nicht-dafür-Grenzen

Dieses Skill NICHT verwenden für:

  • Einfache Wissensfragen → Direkt mit Wissen antworten
  • Dateioperationen ohne Begründung → Dateiverwaltungs-Skill verwenden
  • Direkte Befehlsausführung → Sofort ausführen
  • Unterhaltungsantworten → Natürlich antworten
  • Bereits optimierte Prompts → Zuerst Historie prüfen, um Neuoptimierung zu vermeiden
  • Benutzer sagt explizit „nicht optimieren“ → Benutzervorliebe respektieren

Stattdessen delegieren:

  • Für mathematische Probleme → Auf Berechnung fokussierte Skills verwenden
  • Für kreatives Schreiben → Kreativschreib-Skill verwenden (außer Vorlagenerstellung)
  • Für Datenanalyse → Datenanalyse-Skill verwenden (außer komplexe Begründung erforderlich)
  • Für Debugging → Debugging-Skill verwenden (außer systematische Verbesserung erforderlich)

Grauzonen, die Urteilsvermögen erfordern:

  • Mittelschwere Aufgaben (Punktzahl 2-4) → Zuerst Basis-Performanz testen
  • Fachgebietsanfragen → Nur optimieren, wenn Potenzial für wiederverwendbare Vorlage besteht
  • Folgeantworten → Optimieren, wenn der Umfang deutlich erweitert wird

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

curiositech/windags-skills

Expert in 2000s-era music visualization (Milkdrop, AVS, Geiss) and modern WebGL implementations. Specializes in Butterchurn integration, Web Audio API AnalyserNode FFT data, GLSL shaders for audio-reactive visuals, and psychedelic generative art. Activate on "Milkdrop", "music visualization", "WebGL visualizer", "Butterchurn", "audio reactive", "FFT visualization", "spectrum analyzer". NOT for simple bar charts/waveforms (use basic canvas), video editing, or non-audio visuals.

curiositech/windags-skills

Expert legal research agent for finding and scraping expungement data state by state. Knows authoritative sources, URL patterns, Firecrawl configuration, and 2026 legal landscape.

curiositech/windags-skills

Expert in 3D computer vision labeling tools, workflows, and AI-assisted annotation for LiDAR, point clouds, and sensor fusion. Covers SAM4D/Point-SAM, human-in-the-loop architectures, and vertical-specific training strategies. Activate on '3D labeling', 'point cloud annotation', 'LiDAR labeling', 'SAM 3D', 'SAM4D', 'sensor fusion annotation', '3D bounding box', 'semantic segmentation point cloud'. NOT for 2D image labeling (use clip-aware-embeddings), general ML training (use ml-engineer), video annotation without 3D (use computer-vision-pipeline), or VLM prompt engineering (use prompt-engineer).

curiositech/windags-skills

Implement WCAG 2.2 AA/AAA compliance with automated testing, keyboard navigation, screen reader support, and focus management. Activate on: accessibility audit, WCAG compliance, keyboard navigation, screen reader, aria attributes, axe-core, focus trap. NOT for: design-level accessibility review (use design-accessibility-auditor), color contrast only (use css-in-js-architect).

curiositech/windags-skills

Time-blind friendly planning, executive function support, and daily structure for ADHD brains. Specializes in realistic time estimation, dopamine-aware task design, and building systems that actually work for neurodivergent minds.

curiositech/windags-skills

Designs digital experiences for ADHD brains using neuroscience research and UX principles. Expert in reducing cognitive load, time blindness solutions, dopamine-driven engagement, and compassionate design patterns. Activate on 'ADHD design', 'cognitive load', 'accessibility', 'neurodivergent UX', 'time blindness', 'dopamine-driven', 'executive function'. NOT for general accessibility (WCAG only), neurotypical UX design, or simple UI styling without ADHD context.

curiositech/windags-skills

>- Apply crisis decision-making research to agent routing, uncertainty triage, and coordination failure analysis in time-pressured systems. Use when diagnosing handoff failures, analytical paralysis, or expert judgment under incomplete information. NOT for routine coding, simple CRUD design, or static single-agent tasks with complete information.

curiositech/windags-skills

Extend and modify the admin dashboard, developer portal, and operations console. Use when adding new admin tabs, metrics, monitoring features, or internal tools. Activates for dashboard development, analytics, user management, and internal tooling.

curiositech/windags-skills

Conversation patterns and interaction protocols for multi-agent systems. Covers request/response, pub/sub, blackboard, delegation chains, debate, critique, consensus, fan-out/fan-in, supervisor-worker, and peer negotiation. Deep analysis of AutoGen conversation patterns, CrewAI delegation, LangGraph state passing, and FIPA-ACL performatives. Teaches how to design what agents say to each other and in what order. Activate on: "agent conversation", "agent protocol", "multi-agent debate", "agent delegation", "supervisor worker pattern", "agent voting", "consensus protocol", "fan-out fan-in", "agent negotiation", "blackboard pattern", "agent dialogue", "conversation topology", "agent handoff". NOT for: wire format or serialization (use agent-interchange-formats), orchestration infrastructure (use agentic-infrastructure-2026), single agent behavior (use agentic-patterns).

curiositech/windags-skills

Meta-agent for creating new custom agents, skills, and MCP integrations. Expert in agent design, MCP development, skill architecture, and rapid prototyping. Activate on 'create agent', 'new skill', 'MCP server', 'custom tool', 'agent design'. NOT for using existing agents (invoke them directly), general coding (use language-specific skills), or infrastructure setup (use deployment-engineer).

curiositech/windags-skills

AI-powered calendar management and agent-based scheduling coordination. Covers calendar APIs (Google Calendar, CalDAV/iCal), AI scheduling assistants (Reclaim, Clockwise, Motion, Cal.com), building custom calendar agents with MCP, multi-calendar merging, timezone management, focus block protection, meeting fatigue detection, and agent-to-agent meeting negotiation protocols. Activate on: "calendar agent", "AI scheduling", "calendar coordination", "meeting scheduling", "calendar API", "focus time protection", "calendar optimization", "Google Calendar MCP", "Reclaim", "Clockwise", "Motion", "Cal.com", "smart scheduling", "calendar-aware agent", "timezone scheduling", "agent negotiation meetings". NOT for: manual calendar UI component design (use form-validation-architect), project management scheduling or Gantt charts (use project-management-guru-adhd), general time-tracking or pomodoro apps (use adhd-daily-planner for time-awareness), building the agent itself from scratch (use agent-creator).

curiositech/windags-skills

Build and adopt production AI agent infrastructure in 2026. Covers framework selection (LangGraph, CrewAI, AutoGen, MCP), orchestration patterns, evaluation, observability, memory systems, and tool use. Also covers the SOCIAL dimension: how to sell agent infrastructure internally, change management, measuring ROI, building trust in autonomous systems, and scaling adoption across teams. Activate on: "agent infrastructure", "agent framework comparison", "which agent framework", "sell AI tools internally", "agent adoption", "agent observability", "agent evaluation", "MCP architecture", "agentic mesh", "enterprise AI agents", "AI change management", "agent ROI". NOT for: building specific agents (use ai-engineer), designing agent behavior patterns (use agentic-patterns), prompt tuning (use prompt-engineer).

curiositech/windags-skills

Fundamental patterns for effective agentic behavior. Teaches decomposition, tool orchestration, error recovery, context management, quality self-assessment, and knowing when to stop. Model-agnostic principles that make any agent more effective regardless of domain. Activate on: "how should I structure this agent", "agentic workflow", "agent patterns", "multi-step task", "tool orchestration", "/agentic-patterns", "decompose this", "agent best practices", "chain of actions", "when should the agent stop", "agent loop design". NOT for: creating agent infrastructure (use agent-creator), building DAGs (use windags-architect), specific tool implementation.

curiositech/windags-skills

Automated discovery and matching of agent skills for dynamic task routing and capability assessment

curiositech/windags-skills

Cryptographic security for agentic systems — zero-trust agent networking, signed message envelopes (JWS/JWE), capability-based security (ocaps), Merkle tree audit trails, WASM sandboxing, and formal verification. Covers CLI dev tool security, mTLS between agents, permission boundaries (least privilege for AI agents), and supply chain security for skills/plugins. Activate on: "agent security", "zero trust agents", "secure agent communication", "capability-based security", "ocap", "signed messages between agents", "agent audit trail", "sandbox agent execution", "agent permissions", "mTLS agents", "cryptographic verification", "agent supply chain", "OWASP agentic", "prove agent did X", "tamper-proof agent logs". NOT for: application-level SAST scanning (use security-auditor), network firewall rules (use infrastructure), SOC2/HIPAA compliance (organizational), or prompt injection defense (use prompt-engineer).

curiositech/windags-skills

Data structures and serialization formats for agent-to-agent communication. Covers message envelopes, structured output schemas, capability declarations, task handoff payloads, error/retry signaling, and context windows as data structures. Deep comparison of A2A protocol, MCP, OpenAI function calling, and LangChain message types. Teaches when to use rigid schemas vs free-form with validation, typed vs untyped, streaming vs batch. Activate on: "agent message format", "agent communication schema", "agent-to-agent protocol", "A2A protocol", "MCP message format", "structured output for agents", "agent interop", "interchange format", "agent serialization", "task handoff format", "capability declaration". NOT for: what agents say to each other (use agent-conversation-protocols), orchestration topology (use multi-agent-coordination), building agent infrastructure (use agentic-infrastructure-2026).

curiositech/windags-skills

Logic-based agent programming language implementing BDI architecture for practical autonomous agent development

curiositech/windags-skills

>- Design AgentSpeak(L)-style BDI agents with context-guarded plans, selection functions, and intention stacks. Use for interruptible autonomy, agent policy, and multi-agent orchestration in dynamic environments. NOT for simple rule engines, static planners, or centralized workflows.

curiositech/windags-skills

Foundational concurrent computation model where actors communicate exclusively through asynchronous message passing

curiositech/windags-skills

license: Apache-2.0 NOT for unrelated tasks outside this domain.

Verwandte Skills