Communitygithub.com

curiositech/windags-skills

Wende kognitive Aufgabenanalyse auf Expertenarbeit an, die von perzeptiven Hinweisen, verzweigenden Urteilen und wiederkehrenden Überwachungsschleifen abhängt. Verwende dies, wenn Expertenfähigkeiten in Agentenstruktur, Simulationsdesign oder Validierungsinterviews zerlegt werden sollen. NICHT für gewöhnliche Schritt-für-Schritt-SOP-Erfassung oder einfache Pipelines ohne implizite Hinweisebene.

Was ist windags-skills?

Dieses Skill bietet eine Methodik zur kognitiven Aufgabenanalyse (CTA) für die Entwicklung von KI-Agentenfähigkeiten, die über einfache Checklisten hinausgehen. Es richtet sich an Entwickler, die menschliche Expertenleistung in Agentenarchitekturen, Simulatoren oder Trainingsumgebungen übersetzen. Der Fokus liegt auf der Erfassung perzeptiver Hinweise, Überwachungsschleifen und implizitem Wissen, die entscheidend für die Entscheidungsfindung von Experten sind, aber oft in standardisierten SOPs fehlen. Es unterstützt die Plattformen Claude Code, Cursor und Codex und bietet Entscheidungspunkte, mentale Modelle (z. B. Wissenschafts- vs. Kunstschicht), Fehlermodi und Validierungsstrategien, um sicherzustellen, dass Agentenmodelle nicht nur Prozeduren, sondern auch die situative Urteilsfähigkeit von Experten reproduzieren. Das Skill wird über eine SKILL.md-Datei bereitgestellt, die als Leitfaden für die Aufgabenzerlegung dient.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/curiositech/windags-skills/tree/HEAD/skills/a-task-analysis-of-pier-side-ship-handli

In Ihrer bevorzugten KI fragen

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

Dokumentation

Expertenaufgabenanalyse und Fähigkeitsdesign

Verwende dieses Skill, wenn ein Aufgabenmodell zwar prozedural vollständig erscheint, aber immer noch die perzeptiven Auslöser, Überwachungsschleifen und Werkzeugnutzungsgewohnheiten vermissen lässt, die Expertenleistung von einer Checkliste unterscheiden.

Wann verwenden

  • Du musst Expertenleistung in eine Agentenarchitektur, einen Simulator oder eine Trainingsumgebung umwandeln.
  • Ein schriftlicher SOP erklärt die Schritte, aber nicht, wie Experten wissen, welchen Zweig sie nehmen sollen.
  • Das System funktioniert bei Normalfällen und versagt bei Randfällen, die von situativem Urteilsvermögen abhängen.
  • Du befragst Fachexperten und benötigst eine Methode zur Extraktion impliziten Wissens, nicht nur nacherzählter Verfahren.
  • Ein DAG- oder Orchestrierungsbaum benötigt wiederkehrende Überwachungsschleifen anstelle von nur einmaligen sequentiellen Knoten.

NICHT für Abgrenzungen

Dieses Skill ist nicht das richtige primäre Werkzeug für:

  • Einfache, deterministische Arbeitsabläufe, bei denen explizite Verfahren die gesamte Aufgabe bereits erfassen.
  • Automatisierung mit geringem Risiko, die nicht von der Erkennung perzeptiver Muster abhängt.
  • Nachträgliche Dokumentationsübungen, die keine Validierung anhand echter Expertenleistung benötigen.
  • Simulationen, bei denen visuelle Realismus wichtiger ist als Hinweistreue für die Entscheidungsfindung.

Kern-Mentale Modelle

Wissenschaftsschicht vs. Kunstschicht

Expertenleistung hat eine deklarative Schicht, die Experten normalerweise erklären können, und eine perzeptive Schicht, die oft erst sichtbar wird, wenn man sie zu Verzweigungspunkten drängt. GOMS erfasst Ersteres. Critical-Cue-Inventare und Critical-Decision-Method-Interviews sind die Methoden, um Letzteres wiederherzustellen.

Hinweise sind lasttragend

Erwachensmuster, Leinenspannung, eine Klangveränderung oder eine subtile Positionsbeziehung sind keine dekorativen Details. Sie sind die tatsächlichen Eingaben für die Expertenentscheidung. Wenn das System die Hinweise nicht sehen kann, kann es die Expertenentscheidungsfunktion nicht reproduzieren.

Hierarchie mit Auswahlregeln

Expertenarbeit ist eine verschachtelte Zielhierarchie mit lokalen Verzweigungsbedingungen, keine flache Liste von Schritten. Die wichtige Struktur ist nicht nur, was getan wird, sondern welche Bedingungen Methode A statt Methode B auswählen.

Wiederkehrende Überwachungsschleifen

Viele Expertenaufgaben hängen von kontinuierlichen Bewertungszielen ab, die neben sequentiellen Aktionen ablaufen. Ein Arbeitsablauf, der nur einmalige Knoten modelliert, verliert die Antizipation und verwandelt Expertise in Reaktion.

Validierungslücke

Einzel-Experten-Aufgabenmodelle sind vorhersehbar unvollständig, da Routinewerkzeuge und Einrichtungsverhalten aus dem bewussten Bewusstsein verschwinden. Validierung ist kein optionaler Feinschliff; sie ist der Weg, wie die fehlende Aufgabenstruktur sichtbar wird.

Entscheidungspunkte

Siehe den Modellierungsablauf in diagrams/01_flowchart_decision-points.md.

flowchart TD
  A[Bedarf an Expertenfähigkeitsmodell] --> B[Ziele und Methoden zerlegen]
  B --> C{Verzweigungspunkt prozedural erklärt?}
  C -->|Ja| D[Explizite Auswahlregel aufzeichnen]
  C -->|Nein| E[Nach perzeptiven Hinweisen suchen]
  D --> F{Wiederkehrende Überwachung erforderlich?}
  E --> F
  F -->|Ja| G[Überwachungsschleife und redundante Sensorik modellieren]
  F -->|Nein| H[Sequentielles Unterziel beibehalten]
  G --> I[Mit mehr Experten oder Spuren validieren]
  H --> I

1. Die richtige Granularität der Zerlegung bestimmen

  • Höre auf der Ebene auf, wo eine sinnvolle Methodenauswahl zuerst erscheint.
  • Wenn eine Verzweigungsbedingung noch verborgen ist, zerlege tiefer und untersuche den Hinweis, der den Zweig auswählt.
  • Wenn keine Verzweigungspunkte mehr vorhanden sind, dokumentierst du jetzt die Ausführung und nicht die Aufgabenarchitektur.

2. Die zu verwendende Wissensgewinnungsmethode bestimmen

  • Verwende strukturierte Zerlegung für explizite Verfahren und Werkzeugsequenzen.
  • Verwende Critical-Decision-Method-Sonden, wenn der Experte sagt „Ich weiß es einfach“ oder „es kommt darauf an.“
  • Verwende Multi-Experten-Validierung, wann immer das erste Modell seltsam sauber oder werkzeugfrei erscheint.

3. Bestimmen, was simuliert werden soll

  • Simuliere Hinweise, die tatsächlich Verzweigungsentscheidungen auslösen.
  • Füge redundante Sensorik hinzu, wo Experten sich auf mehr als einen Kanal verlassen.
  • Lasse kosmetische Details weg, die die Hinweiserkennung oder Entscheidungsqualität nicht verändern.

Fehlermodi

1. Flache Checklisten-Erfassung

Symptome: Das Aufgabenmodell liest sich flüssig, versagt aber, sobald die Umgebung abweicht. Erkennungsregel: Verzweigungsbedingungen fehlen oder sind in Prosa versteckt anstatt als explizite Auswahlregeln. Wiederherstellung: Wandle die Checkliste in eine Zielhierarchie mit hinweisverknüpften Verzweigungspunkten um.

2. Hinweisfreie Simulation

Symptome: Auszubildende oder Agenten haben im Simulator Erfolg, versagen aber im Einsatz. Erkennungsregel: Die Simulation reproduziert Verfahren, aber nicht die Signale, die Experten zur Auswahl zwischen ihnen verwenden. Wiederherstellung: Erstelle ein Critical-Cue-Inventar und gestalte die Umgebung neu, mit Fokus auf Hinweistreue.

3. Einkanal-Fragilität

Symptome: Ein verrauschter oder fehlender Eingabe lässt den gesamten Entscheidungsprozess zusammenbrechen. Erkennungsregel: Ein kritisches Urteil hängt von genau einer Quelle ab. Wiederherstellung: Füge redundante Kanäle und explizites Quervergleichsverhalten hinzu.

4. Ein-Experten-Blinder Fleck

Symptome: Wesentliche Werkzeuge oder kontextsetzende Handlungen tauchen im ersten Modell nie auf. Erkennungsregel: Validierungsexperten erwähnen sofort fehlende Ausrüstung, Routinen oder Überwachungsverhalten. Wiederherstellung: Behandle Meinungsverschiedenheiten als Beweis für fehlende Struktur, nicht als Rauschen.

5. Nur-Sequentiell-Architektur

Symptome: Das System kann auf Ereignisse reagieren, aber keine fortlaufende Bewertung aufrechterhalten. Erkennungsregel: Alle Knoten sind einmalige Aufgaben und keiner repräsentiert wiederkehrende Überwachungsziele. Wiederherstellung: Füge explizite Überwachungsschleifen mit Vorhersage-Beobachten-Vergleichen-Anpassen-Verhalten hinzu.

Ausgearbeitete Beispiele

Beispiel 1: Expertenurteil in einen Agentenbaum umwandeln

Ein Experte aus der Schifffahrtsdomäne gibt einen prozeduralen Bericht zum Anlegen. Der erste Entwurf zerlegt sauber in Schritte, versagt aber, wenn Strom, Schlepperverfügbarkeit und Leinenverhalten sich gleichzeitig ändern. Das Skill fügt Auswahlregeln an den relevanten Verzweigungspunkten hinzu, zeichnet das Hinweisinventar auf, das diese Entscheidungen treibt, und führt wiederkehrende Überwachungsschleifen anstelle von nur sequentiellen Knoten ein.

Beispiel 2: Simulationstreue-Trlage

Ein Trainingssimulator gibt Wasser, Schiffe und Piergeometrie schön wieder, dennoch überschießen Auszubildende den Stoppunkt. Die kognitive Aufgabenanalyse (CTA) zeigt, dass Experten sich auf relative Bewegung gegenüber festen Uferreferenzen und Leinenspannungshinweise verlassen, die der Simulator nie betont. Das Skill lenkt den Designaufwand auf diese Hinweise statt auf mehr visuelle Politur.

Qualitätsgates

  • Das Aufgabenmodell unterscheidet explizites Verfahren von perzeptivem Hinweiswissen.
  • Verzweigungspunkte enthalten die Hinweise oder Bedingungen, die jede Methode auswählen.
  • Wiederkehrende Überwachungsziele werden getrennt von einmaligen sequentiellen Zielen modelliert.
  • Kritische Entscheidungen haben redundante Informationskanäle, wo Experten sich darauf verlassen.
  • Mindestens ein Validierungsdurchlauf stellt das Modell mit zusätzlichen Experten oder Spuren in Frage.

Referenzdateien

DateiLaden, wenn
references/goms-task-decomposition-for-agent-systems.mdEine Zielhierarchie erstellen oder Zerlegungstiefe bestimmen
references/critical-cue-inventories-for-agent-perception.mdPerzeptive Auslöser an Entscheidungspunkten wiederherstellen
references/knowledge-elicitation-methodology-for-agent-capability-building.mdCTA- oder Critical-Decision-Method-Interviews durchführen
references/validation-gap-what-experts-dont-know-they-know.mdErstentwurf eines Aufgabenmodells stresstesten
references/redundant-sensing-in-multi-channel-environments.mdRobuste Mehrkanal-Wahrnehmung entwerfen
references/the-art-science-gap-transfer-to-simulation.mdBestimmen, welches Simulationsdetail den Fähigkeitstransfer wesentlich beeinflusst
references/situation-awareness-and-the-conning-officers-mental-model.mdÜberwachungsschleifen und Abweichungserkennung modellieren

Anti-Patterns

  • „Implizites Wissen“ als Label behandeln, das die Untersuchung beendet, anstatt als Signal für intensiveres Sondieren.
  • Nur Verfahren erfassen und das Ergebnis als Expertenmodell bezeichnen.
  • Simulationen für Realismus-Ästhetik statt für Hinweistreue entwerfen.
  • Einzel-Experten-Vollständigkeit in einer Domäne annehmen, in der Automatisierung die wichtigste Struktur verbirgt.

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