The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
fix: normalize codex skill metadata
Affaan Mustafad89f8d895dde
diff --git a/.agents/skills/agent-introspection-debugging/SKILL.md b/.agents/skills/agent-introspection-debugging/SKILL.mdindex ea5a2c584..fb668bcc9 100644--- a/.agents/skills/agent-introspection-debugging/SKILL.md+++ b/.agents/skills/agent-introspection-debugging/SKILL.md@@ -1,7 +1,6 @@---name: agent-introspection-debuggingdescription: Structured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and introspection reports.-origin: ECC---# Agent Introspection Debuggingdiff --git a/.agents/skills/agent-introspection-debugging/agents/openai.yaml b/.agents/skills/agent-introspection-debugging/agents/openai.yamlnew file mode 100644index 000000000..4d53a0d73--- /dev/null+++ b/.agents/skills/agent-introspection-debugging/agents/openai.yaml@@ -0,0 +1,7 @@+interface:+ display_name: "Agent Introspection Debugging"+ short_description: "Structured self-debugging for AI agent failures"+ brand_color: "#0EA5E9"+ default_prompt: "Use $agent-introspection-debugging to diagnose and recover from an AI agent failure."+policy:+ allow_implicit_invocation: truediff --git a/.agents/skills/agent-sort/SKILL.md b/.agents/skills/agent-sort/SKILL.mdindex e50e9e8b5..4daf0a7c2 100644--- a/.agents/skills/agent-sort/SKILL.md+++ b/.agents/skills/agent-sort/SKILL.md@@ -1,7 +1,6 @@---name: agent-sortdescription: Build an evidence-backed ECC install plan for a specific repo by sorting skills, commands, rules, hooks, and extras into DAILY vs LIBRARY buckets using parallel repo-aware review passes. Use when ECC should be trimmed to what a project actually needs instead of loading the full bundle.-origin: ECC---# Agent Sortdiff --git a/.agents/skills/agent-sort/agents/openai.yaml b/.agents/skills/agent-sort/agents/openai.yamlnew file mode 100644index 000000000..85832bc20--- /dev/null+++ b/.agents/skills/agent-sort/agents/openai.yaml@@ -0,0 +1,7 @@+interface:+ display_name: "Agent Sort"+ short_description: "Evidence-backed ECC install planning"+ brand_color: "#0EA5E9"+ default_prompt: "Use $agent-sort to build an evidence-backed ECC install plan."+policy:+ allow_implicit_invocation: truediff --git a/.agents/skills/api-design/SKILL.md b/.agents/skills/api-design/SKILL.mdindex a45aca06d..4a9aa4176 100644--- a/.agents/skills/api-design/SKILL.md+++ b/.agents/skills/api-design/SKILL.md@@ -1,7 +1,6 @@---name: api-designdescription: REST API design patterns including resource naming, status codes, pagination, filtering, error responses, versioning, and rate limiting for production APIs.-origin: ECC---# API Design Patternsdiff --git a/.agents/skills/api-design/agents/openai.yaml b/.agents/skills/api-design/agents/openai.yamlindex b83fe25f3..9daa40121 100644--- a/.agents/skills/api-design/agents/openai.yaml+++ b/.agents/skills/api-design/agents/openai.yaml@@ -2,6 +2,6 @@ interface:display_name: "API Design"short_description: "REST API design patterns and best practices"brand_color: "#F97316"- default_prompt: "Design REST API: resources, status codes, pagination"+ default_prompt: "Use $api-design to design production REST API resources and responses."policy:allow_implicit_invocation: truediff --git a/.agents/skills/article-writing/SKILL.md b/.agents/skills/article-writing/SKILL.mdindex 6cf4339c7..2f17b3e67 100644--- a/.agents/skills/article-writing/SKILL.md+++ b/.agents/skills/article-writing/SKILL.md@@ -1,7 +1,6 @@---name: article-writingdescription: Write articles, guides, blog posts, tutorials, newsletter issues, and other long-form content in a distinctive voice derived from supplied examples or brand guidance. Use when the user wants polished written content longer than a paragraph, especially when voice consistency, structure, and credibility matter.-origin: ECC---# Article Writingdiff --git a/.agents/skills/article-writing/agents/openai.yaml b/.agents/skills/article-writing/agents/openai.yamlindex 41f14377f..14dfe51ea 100644--- a/.agents/skills/article-writing/agents/openai.yaml+++ b/.agents/skills/article-writing/agents/openai.yaml@@ -1,7 +1,7 @@interface:display_name: "Article Writing"- short_description: "Write long-form content in a supplied voice without sounding templated"+ short_description: "Long-form content in a supplied voice"brand_color: "#B45309"- default_prompt: "Draft a sharp long-form article from these notes and examples"+ default_prompt: "Use $article-writing to draft polished long-form content in the supplied voice."policy:allow_implicit_invocation: truediff --git a/.agents/skills/backend-patterns/SKILL.md b/.agents/skills/backend-patterns/SKILL.mdindex 30898b4d4..aa049462c 100644--- a/.agents/skills/backend-patterns/SKILL.md+++ b/.agents/skills/backend-patterns/SKILL.md@@ -1,7 +1,6 @@---name: backend-patternsdescription: Backend architecture patterns, API design, database optimization, and server-side best practices for Node.js, Express, and Next.js API routes.-origin: ECC---# Backend Development Patternsdiff --git a/.agents/skills/backend-patterns/agents/openai.yaml b/.agents/skills/backend-patterns/agents/openai.yamlindex 5fb47c634..9ef955677 100644--- a/.agents/skills/backend-patterns/agents/openai.yaml+++ b/.agents/skills/backend-patterns/agents/openai.yaml@@ -1,7 +1,7 @@interface:display_name: "Backend Patterns"- short_description: "API design, database, and server-side patterns"+ short_description: "API, database, and server-side patterns"brand_color: "#F59E0B"- default_prompt: "Apply backend patterns: API design, repository, caching"+ default_prompt: "Use $backend-patterns to apply backend architecture and API patterns."policy:allow_implicit_invocation: truediff --git a/.agents/skills/brand-voice/SKILL.md b/.agents/skills/brand-voice/SKILL.mdindex 5debed023..0ade4fc0d 100644--- a/.agents/skills/brand-voice/SKILL.md+++ b/.agents/skills/brand-voice/SKILL.md@@ -1,7 +1,6 @@---name: brand-voicedescription: Build a source-derived writing style profile from real posts, essays, launch notes, docs, or site copy, then reuse that profile across content, outreach, and social workflows. Use when the user wants voice consistency without generic AI writing tropes.-origin: ECC---# Brand Voicediff --git a/.agents/skills/brand-voice/agents/openai.yaml b/.agents/skills/brand-voice/agents/openai.yamlnew file mode 100644index 000000000..42a51a14f--- /dev/null+++ b/.agents/skills/brand-voice/agents/openai.yaml@@ -0,0 +1,7 @@+interface:+ display_name: "Brand Voice"+ short_description: "Source-derived writing style profiles"+ brand_color: "#0EA5E9"+ default_prompt: "Use $brand-voice to derive and reuse a source-grounded writing style."+policy:+ allow_implicit_invocation: truediff --git a/.agents/skills/bun-runtime/SKILL.md b/.agents/skills/bun-runtime/SKILL.mdindex 144e9a0c3..deb1f506c 100644--- a/.agents/skills/bun-runtime/SKILL.md+++ b/.agents/skills/bun-runtime/SKILL.md@@ -1,7 +1,6 @@---name: bun-runtimedescription: Bun as runtime, package manager, bundler, and test runner. When to choose Bun vs Node, migration notes, and Vercel support.-origin: ECC---# Bun Runtimediff --git a/.agents/skills/bun-runtime/agents/openai.yaml b/.agents/skills/bun-runtime/agents/openai.yamlindex 1eb8fa117..6460a67d2 100644--- a/.agents/skills/bun-runtime/agents/openai.yaml+++ b/.agents/skills/bun-runtime/agents/openai.yaml@@ -1,7 +1,7 @@interface:display_name: "Bun Runtime"- short_description: "Bun as runtime, package manager, bundler, and test runner"+ short_description: "Bun runtime, package manager, and test runner"brand_color: "#FBF0DF"- default_prompt: "Use Bun for scripts, install, or run"+ default_prompt: "Use $bun-runtime to choose and apply Bun runtime workflows."policy:allow_implicit_invocation: truediff --git a/.agents/skills/claude-api/SKILL.md b/.agents/skills/claude-api/SKILL.mdindex 0c09b7401..c95b82bd5 100644--- a/.agents/skills/claude-api/SKILL.md+++ b/.agents/skills/claude-api/SKILL.md@@ -1,7 +1,6 @@---name: claude-apidescription: Anthropic Claude API patterns for Python and TypeScript. Covers Messages API, streaming, tool use, vision, extended thinking, batches, prompt caching, and Claude Agent SDK. Use when building applications with the Claude API or Anthropic SDKs.-origin: ECC---# Claude APIdiff --git a/.agents/skills/claude-api/agents/openai.yaml b/.agents/skills/claude-api/agents/openai.yamlindex 9db910fc9..30f874c93 100644--- a/.agents/skills/claude-api/agents/openai.yaml+++ b/.agents/skills/claude-api/agents/openai.yaml@@ -1,7 +1,7 @@interface:display_name: "Claude API"- short_description: "Anthropic Claude API patterns and SDKs"+ short_description: "Claude API patterns for Python and TypeScript"brand_color: "#D97706"- default_prompt: "Build applications with the Claude API using Messages, tool use, streaming, and Agent SDK"+ default_prompt: "Use $claude-api to build with Claude API and Anthropic SDK patterns."policy:allow_implicit_invocation: truediff --git a/.agents/skills/coding-standards/SKILL.md b/.agents/skills/coding-standards/SKILL.mdindex 48a628114..741136f69 100644--- a/.agents/skills/coding-standards/SKILL.md+++ b/.agents/skills/coding-standards/SKILL.md@@ -1,7 +1,6 @@---name: coding-standardsdescription: Baseline cross-project coding conventions for naming, readability, immutability, and code-quality review. Use detailed frontend or backend skills for framework-specific patterns.-origin: ECC---# Coding Standards & Best Practicesdiff --git a/.agents/skills/coding-standards/agents/openai.yaml b/.agents/skills/coding-standards/agents/openai.yamlindex b0dda0eff..8dd9c4228 100644--- a/.agents/skills/coding-standards/agents/openai.yaml+++ b/.agents/skills/coding-standards/agents/openai.yaml@@ -1,7 +1,7 @@interface:display_name: "Coding Standards"- short_description: "Universal coding standards and best practices"+ short_description: "Cross-project coding conventions and review"brand_color: "#3B82F6"- default_prompt: "Apply standards: immutability, error handling, type safety"+ default_prompt: "Use $coding-standards to review code against cross-project standards."policy:allow_implicit_invocation: truediff --git a/.agents/skills/content-engine/SKILL.md b/.agents/skills/content-engine/SKILL.mdindex 4467724ae..5c9e2e3f2 100644--- a/.agents/skills/content-engine/SKILL.md+++ b/.agents/skills/content-engine/SKILL.md@@ -1,7 +1,6 @@---name: content-enginedescription: Create platform-native content systems for X, LinkedIn, TikTok, YouTube, newsletters, and repurposed multi-platform campaigns. Use when the user wants social posts, threads, scripts, content calendars, or one source asset adapted cleanly across platforms.-origin: ECC---# Content Enginediff --git a/.agents/skills/content-engine/agents/openai.yaml b/.agents/skills/content-engine/agents/openai.yamlindex 739576c9a..c77f5080f 100644--- a/.agents/skills/content-engine/agents/openai.yaml+++ b/.agents/skills/content-engine/agents/openai.yaml@@ -1,7 +1,7 @@interface:display_name: "Content Engine"- short_description: "Turn one idea into platform-native social and content outputs"+ short_description: "Platform-native content systems and campaigns"brand_color: "#DC2626"- default_prompt: "Turn this source asset into strong multi-platform content"+ default_prompt: "Use $content-engine to turn source material into platform-native content."policy:allow_implicit_invocation: truediff --git a/.agents/skills/crosspost/SKILL.md b/.agents/skills/crosspost/SKILL.mdindex e94df3c31..db4e9dc00 100644--- a/.agents/skills/crosspost/SKILL.md+++ b/.agents/skills/crosspost/SKILL.md@@ -1,7 +1,6 @@---name: crosspostdescription: Multi-platform content distribution across X, LinkedIn, Threads, and Bluesky. Adapts content per platform using content-engine patterns. Never posts identical content cross-platform. Use when the user wants to distribute content across social platforms.-origin: ECC---# Crosspostdiff --git a/.agents/skills/crosspost/agents/openai.yaml b/.agents/skills/crosspost/agents/openai.yamlindex c2534142d..57866de8b 100644--- a/.agents/skills/crosspost/agents/openai.yaml+++ b/.agents/skills/crosspost/agents/openai.yaml@@ -1,7 +1,7 @@interface:display_name: "Crosspost"- short_description: "Multi-platform content distribution with native adaptation"+ short_description: "Multi-platform social distribution"brand_color: "#EC4899"- default_prompt: "Distribute content across X, LinkedIn, Threads, and Bluesky with platform-native adaptation"+ default_prompt: "Use $crosspost to adapt content for multiple social platforms."policy:allow_implicit_invocation: truediff --git a/.agents/skills/deep-research/SKILL.md b/.agents/skills/deep-research/SKILL.mdindex 5a412b7e5..db7b8e6d1 100644--- a/.agents/skills/deep-research/SKILL.md+++ b/.agents/skills/deep-research/SKILL.md@@ -1,7 +1,6 @@---name: deep-researchdescription: Multi-source deep research using firecrawl and exa MCPs. Searches the web, synthesizes findings, and delivers cited reports with source attribution. Use when the user wants thorough research on any topic with evidence and citations.-origin: ECC---# Deep Researchdiff --git a/.agents/skills/deep-research/agents/openai.yaml b/.agents/skills/deep-research/agents/openai.yamlindex 51ac12b1a..529e81eb7 100644--- a/.agents/skills/deep-research/agents/openai.yaml+++ b/.agents/skills/deep-research/agents/openai.yaml@@ -1,7 +1,7 @@interface:display_name: "Deep Research"- short_description: "Multi-source deep research with firecrawl and exa MCPs"+ short_description: "Multi-source cited research reports"brand_color: "#6366F1"- default_prompt: "Research the given topic using firecrawl and exa, produce a cited report"+ default_prompt: "Use $deep-research to produce a cited multi-source research report."policy:allow_implicit_invocation: truediff --git a/.agents/skills/dmux-workflows/SKILL.md b/.agents/skills/dmux-workflows/SKILL.mdindex 813cc91cd..c3bd27985 100644--- a/.agents/skills/dmux-workflows/SKILL.md+++ b/.agents/skills/dmux-workflows/SKILL.md@@ -1,7 +1,6 @@---name: dmux-workflowsdescription: Multi-agent orchestration using dmux (tmux pane manager for AI agents). Patterns for parallel agent workflows across Claude Code, Codex, OpenCode, and other harnesses. Use when running multiple agent sessions in parallel or coordinating multi-agent development workflows.-origin: ECC---# dmux Workflowsdiff --git a/.agents/skills/dmux-workflows/agents/openai.yaml b/.agents/skills/dmux-workflows/agents/openai.yamlindex 8147fea8b..e2c8dece5 100644--- a/.agents/skills/dmux-workflows/agents/openai.yaml+++ b/.agents/skills/dmux-workflows/agents/openai.yaml@@ -2,6 +2,6 @@ interface:display_name: "dmux Workflows"short_description: "Multi-agent orchestration with dmux"brand_color: "#14B8A6"- default_prompt: "Orchestrate parallel agent sessions using dmux pane manager"+ default_prompt: "Use $dmux-workflows to orchestrate parallel agent sessions with dmux."policy:allow_implicit_invocation: truediff --git a/.agents/skills/documentation-lookup/SKILL.md b/.agents/skills/documentation-lookup/SKILL.mdindex 148ac841f..8a389f9b0 100644--- a/.agents/skills/documentation-lookup/SKILL.md+++ b/.agents/skills/documentation-lookup/SKILL.md@@ -1,7 +1,6 @@---name: documentation-lookupdescription: Use up-to-date library and framework docs via Context7 MCP instead of training data. Activates for setup questions, API references, code examples, or when the user names a framework (e.g. React, Next.js, Prisma).-origin: ECC---# Documentation Lookup (Context7)diff --git a/.agents/skills/documentation-lookup/agents/openai.yaml b/.agents/skills/documentation-lookup/agents/openai.yamlindex b7d4b48fe..ea1a69370 100644--- a/.agents/skills/documentation-lookup/agents/openai.yaml+++ b/.agents/skills/documentation-lookup/agents/openai.yaml@@ -1,7 +1,7 @@interface:display_name: "Documentation Lookup"- short_description: "Fetch up-to-date library docs via Context7 MCP"+ short_description: "Current library docs via Context7"brand_color: "#6366F1"- default_prompt: "Look up docs for a library or API"+ default_prompt: "Use $documentation-lookup to fetch current library documentation via Context7."policy:allow_implicit_invocation: truediff --git a/.agents/skills/e2e-testing/SKILL.md b/.agents/skills/e2e-testing/SKILL.mdindex 056319914..640927741 100644--- a/.agents/skills/e2e-testing/SKILL.md+++ b/.agents/skills/e2e-testing/SKILL.md@@ -1,7 +1,6 @@---name: e2e-testingdescription: Playwright E2E testing patterns, Page Object Model, configuration, CI/CD integration, artifact management, and flaky test strategies.-origin: ECC---# E2E Testing Patternsdiff --git a/.agents/skills/e2e-testing/agents/openai.yaml b/.agents/skills/e2e-testing/agents/openai.yamlindex cdedda78c..6f44f3d02 100644--- a/.agents/skills/e2e-testing/agents/openai.yaml+++ b/.agents/skills/e2e-testing/agents/openai.yaml@@ -1,7 +1,7 @@interface:display_name: "E2E Testing"- short_description: "Playwright end-to-end testing"+ short_description: "Playwright E2E testing patterns"brand_color: "#06B6D4"- default_prompt: "Generate Playwright E2E tests with Page Object Model"+ default_prompt: "Use $e2e-testing to design Playwright end-to-end test coverage."policy:allow_implicit_invocation: truediff --git a/.agents/skills/eval-harness/SKILL.md b/.agents/skills/eval-harness/SKILL.mdindex d320670c9..8dcd809aa 100644--- a/.agents/skills/eval-harness/SKILL.md+++ b/.agents/skills/eval-harness/SKILL.md@@ -1,8 +1,7 @@---name: eval-harnessdescription: Formal evaluation framework for Claude Code sessions implementing eval-driven development (EDD) principles-origin: ECC-tools: Read, Write, Edit, Bash, Grep, Glob+allowed-tools: Read, Write, Edit, Bash, Grep, Glob---# Eval Harness Skilldiff --git a/.agents/skills/eval-harness/agents/openai.yaml b/.agents/skills/eval-harness/agents/openai.yamlindex e017e6a7e..d55d58d04 100644--- a/.agents/skills/eval-harness/agents/openai.yaml+++ b/.agents/skills/eval-harness/agents/openai.yaml@@ -1,7 +1,7 @@interface:display_name: "Eval Harness"- short_description: "Eval-driven development with pass/fail criteria"+ short_description: "Eval-driven development harnesses"brand_color: "#EC4899"- default_prompt: "Set up eval-driven development with pass/fail criteria"+ default_prompt: "Use $eval-harness to define eval-driven development checks."policy:allow_implicit_invocation: truediff --git a/.agents/skills/everything-claude-code/SKILL.md b/.agents/skills/everything-claude-code/SKILL.mdindex 173826a88..9a92c67fa 100644--- a/.agents/skills/everything-claude-code/SKILL.md+++ b/.agents/skills/everything-claude-code/SKILL.md@@ -1,5 +1,5 @@----name: everything-claude-code-conventions+name: everything-claude-codedescription: Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.---diff --git a/.agents/skills/everything-claude-code/agents/openai.yaml b/.agents/skills/everything-claude-code/agents/openai.yamlindex 410a5bf87..ca4f70294 100644--- a/.agents/skills/everything-claude-code/agents/openai.yaml+++ b/.agents/skills/everything-claude-code/agents/openai.yaml@@ -1,6 +1,7 @@interface:display_name: "Everything Claude Code"- short_description: "Repo-specific patterns and workflows for everything-claude-code"- default_prompt: "Use the everything-claude-code repo skill to follow existing architecture, testing, and workflow conventions."+ short_description: "Repo workflows for everything-claude-code"+ brand_color: "#0EA5E9"+ default_prompt: "Use $everything-claude-code to follow this repository's conventions and workflows."policy:- allow_implicit_invocation: true\ No newline at end of file+ allow_implicit_invocation: truediff --git a/.agents/skills/exa-search/SKILL.md b/.agents/skills/exa-search/SKILL.mdindex 37ea2b1b2..1d3e5cb6e 100644--- a/.agents/skills/exa-search/SKILL.md+++ b/.agents/skills/exa-search/SKILL.md@@ -1,7 +1,6 @@---name: exa-searchdescription: Neural search via Exa MCP for web, code, and company research. Use when the user needs web search, code examples, company intel, people lookup, or AI-powered deep research with Exa's neural search engine.-origin: ECC---# Exa Searchdiff --git a/.agents/skills/exa-search/agents/openai.yaml b/.agents/skills/exa-search/agents/openai.yamlindex 80d26bd30..d8a6c58da 100644--- a/.agents/skills/exa-search/agents/openai.yaml+++ b/.agents/skills/exa-search/agents/openai.yaml@@ -1,7 +1,7 @@interface:display_name: "Exa Search"- short_description: "Neural search via Exa MCP for web, code, and companies"+ short_description: "Neural search via Exa MCP"brand_color: "#8B5CF6"- default_prompt: "Search using Exa MCP tools for web content, code, or company research"+ default_prompt: "Use $exa-search to search web, code, or company data through Exa."policy:allow_implicit_invocation: truediff --git a/.agents/skills/fal-ai-media/SKILL.md b/.agents/skills/fal-ai-media/SKILL.mdindex cfada8df0..a694690fa 100644--- a/.agents/skills/fal-ai-media/SKILL.md+++ b/.agents/skills/fal-ai-media/SKILL.md@@ -1,7 +1,6 @@---name: fal-ai-mediadescription: Unified media generation via fal.ai MCP — image, video, and audio. Covers text-to-image (Nano Banana), text/image-to-video (Seedance, Kling, Veo 3), text-to-speech (CSM-1B), and video-to-audio (ThinkSound). Use when the user wants to generate images, videos, or audio with AI.-origin: ECC---# fal.ai Media Generationdiff --git a/.agents/skills/fal-ai-media/agents/openai.yaml b/.agents/skills/fal-ai-media/agents/openai.yamlindex d20f8ab02..679efa45e 100644--- a/.agents/skills/fal-ai-media/agents/openai.yaml+++ b/.agents/skills/fal-ai-media/agents/openai.yaml@@ -1,7 +1,7 @@interface:display_name: "fal.ai Media"- short_description: "AI image, video, and audio generation via fal.ai"+ short_description: "AI media generation via fal.ai"brand_color: "#F43F5E"- default_prompt: "Generate images, videos, or audio using fal.ai models"+ default_prompt: "Use $fal-ai-media to generate image, video, or audio assets with fal.ai."policy:allow_implicit_invocation: truediff --git a/.agents/skills/frontend-design/SKILL.md b/.agents/skills/frontend-design/SKILL.mdindex 7f0b0c3ac..80498799d 100644--- a/.agents/skills/frontend-design/SKILL.md+++ b/.agents/skills/frontend-design/SKILL.md@@ -1,7 +1,6 @@---name: frontend-designdescription: Create distinctive, production-grade frontend interfaces with high design quality. Use when the user asks to build web components, pages, or applications and the visual direction matters as much as the code quality.-origin: ECC---# Frontend Designdiff --git a/.agents/skills/frontend-design/agents/openai.yaml b/.agents/skills/frontend-design/agents/openai.yamlnew file mode 100644index 000000000..ee2ab4571--- /dev/null+++ b/.agents/skills/frontend-design/agents/openai.yaml@@ -0,0 +1,7 @@+interface:+ display_name: "Frontend Design"+ short_description: "Production-grade frontend interface design"+ brand_color: "#0EA5E9"+ default_prompt: "Use $frontend-design to build a distinctive production-grade interface."+policy:+ allow_implicit_invocation: truediff --git a/.agents/skills/frontend-patterns/SKILL.md b/.agents/skills/frontend-patterns/SKILL.mdindex ef0de63f2..51ed4d361 100644--- a/.agents/skills/frontend-patterns/SKILL.md+++ b/.agents/skills/frontend-patterns/SKILL.md@@ -1,7 +1,6 @@---name: frontend-patternsdescription: Frontend development patterns for React, Next.js, state management, performance optimization, and UI best practices.-origin: ECC---# Frontend Development Patternsdiff --git a/.agents/skills/frontend-patterns/agents/openai.yaml b/.agents/skills/frontend-patterns/agents/openai.yamlindex 00f859956..fb66e8499 100644--- a/.agents/skills/frontend-patterns/agents/openai.yaml+++ b/.agents/skills/frontend-patterns/agents/openai.yaml@@ -1,7 +1,7 @@interface:display_name: "Frontend Patterns"- short_description: "React and Next.js patterns and best practices"+ short_description: "React and Next.js frontend patterns"brand_color: "#8B5CF6"- default_prompt: "Apply React/Next.js patterns and best practices"+ default_prompt: "Use $frontend-patterns to apply React and Next.js frontend patterns."policy:allow_implicit_invocation: truediff --git a/.agents/skills/frontend-slides/SKILL.md b/.agents/skills/frontend-slides/SKILL.mdindex 3d41eb4fa..32d4f9515 100644--- a/.agents/skills/frontend-slides/SKILL.md+++ b/.agents/skills/frontend-slides/SKILL.md@@ -1,7 +1,6 @@---name: frontend-slidesdescription: Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.-origin: ECC---# Frontend Slidesdiff --git a/.agents/skills/frontend-slides/agents/openai.yaml b/.agents/skills/frontend-slides/agents/openai.yamlindex 9c23da907..e1f271d99 100644--- a/.agents/skills/frontend-slides/agents/openai.yaml+++ b/.agents/skills/frontend-slides/agents/openai.yaml@@ -1,7 +1,7 @@interface:display_name: "Frontend Slides"- short_description: "Create distinctive HTML slide decks and convert PPTX to web"+ short_description: "Animation-rich HTML presentation decks"brand_color: "#FF6B3D"- default_prompt: "Create a viewport-safe HTML presentation with strong visual direction"+ default_prompt: "Use $frontend-slides to create an animation-rich HTML presentation deck."policy:allow_implicit_invocation: truediff --git a/.agents/skills/investor-materials/SKILL.md b/.agents/skills/investor-materials/SKILL.mdindex e392706af..9d69eb6ee 100644--- a/.agents/skills/investor-materials/SKILL.md+++ b/.agents/skills/investor-materials/SKILL.md@@ -1,7 +1,6 @@---name: investor-materialsdescription: Create and update pitch decks, one-pagers, investor memos, accelerator applications, financial models, and fundraising materials. Use when the user needs investor-facing documents, projections, use-of-funds tables, milestone plans, or materials that must stay internally consistent across multiple fundraising assets.-origin: ECC---# Investor Materialsdiff --git a/.agents/skills/investor-materials/agents/openai.yaml b/.agents/skills/investor-materials/agents/openai.yamlindex 9ebfc93b0..facecc9f4 100644--- a/.agents/skills/investor-materials/agents/openai.yaml+++ b/.agents/skills/investor-materials/agents/openai.yaml@@ -1,7 +1,7 @@interface:display_name: "Investor Materials"- short_description: "Create decks, memos, and financial materials from one source of truth"+ short_description: "Investor decks, memos, and financial materials"brand_color: "#7C3AED"- default_prompt: "Draft investor materials that stay numerically consistent across assets"+ default_prompt: "Use $investor-materials to draft consistent investor-facing fundraising assets."policy:allow_implicit_invocation: truediff --git a/.agents/skills/investor-outreach/SKILL.md b/.agents/skills/investor-outreach/SKILL.mdindex f34860e42..ce216e083 100644--- a/.agents/skills/investor-outreach/SKILL.md+++ b/.agents/skills/investor-outreach/SKILL.md@@ -1,7 +1,6 @@---name: investor-outreachdescription: Draft cold emails, warm intro blurbs, follow-ups, update emails, and investor communications for fundraising. Use when the user wants outreach to angels, VCs, strategic investors, or accelerators and needs concise, personalized, investor-facing messaging.-origin: ECC---# Investor Outreachdiff --git a/.agents/skills/investor-outreach/agents/openai.yaml b/.agents/skills/investor-outreach/agents/openai.yamlindex fc5a63858..8181eaa14 100644--- a/.agents/skills/investor-outreach/agents/openai.yaml+++ b/.agents/skills/investor-outreach/agents/openai.yaml@@ -1,7 +1,7 @@interface:display_name: "Investor Outreach"- short_description: "Write concise, personalized outreach and follow-ups for fundraising"+ short_description: "Personalized investor outreach and follow-ups"brand_color: "#059669"- default_prompt: "Draft a personalized investor outreach email with a clear low-friction ask"+ default_prompt: "Use $investor-outreach to write concise personalized investor outreach."policy:allow_implicit_invocation: truediff --git a/.agents/skills/market-research/SKILL.md b/.agents/skills/market-research/SKILL.mdindex 12ffa034b..10c7a7643 100644--- a/.agents/skills/market-research/SKILL.md+++ b/.agents/skills/market-research/SKILL.md@@ -1,7 +1,6 @@---name: market-researchdescription: Conduct market research, competitive analysis, investor due diligence, and industry intelligence with source attribution and decision-oriented summaries. Use when the user wants market sizing, competitor comparisons, fund research, technology scans, or research that informs business decisions.-origin: ECC---# Market Researchdiff --git a/.agents/skills/market-research/agents/openai.yaml b/.agents/skills/market-research/agents/openai.yamlindex 828a4588c..749e6decc 100644--- a/.agents/skills/market-research/agents/openai.yaml+++ b/.agents/skills/market-research/agents/openai.yaml@@ -1,7 +1,7 @@interface:display_name: "Market Research"- short_description: "Source-attributed market, competitor, and investor research"+ short_description: "Source-attributed market research"brand_color: "#2563EB"- default_prompt: "Research this market and summarize the decision-relevant findings"+ default_prompt: "Use $market-research to research markets with source-attributed findings."policy:allow_implicit_invocation: truediff --git a/.agents/skills/mcp-server-patterns/SKILL.md b/.agents/skills/mcp-server-patterns/SKILL.mdindex a3dea9cf0..b5ac7c2b8 100644--- a/.agents/skills/mcp-server-patterns/SKILL.md+++ b/.agents/skills/mcp-server-patterns/SKILL.md@@ -1,7 +1,6 @@---name: mcp-server-patternsdescription: Build MCP servers with Node/TypeScript SDK — tools, resources, prompts, Zod validation, stdio vs Streamable HTTP. Use Context7 or official MCP docs for latest API.-origin: ECC---# MCP Server Patternsdiff --git a/.agents/skills/mcp-server-patterns/agents/openai.yaml b/.agents/skills/mcp-server-patterns/agents/openai.yamlnew file mode 100644index 000000000..97a94adeb--- /dev/null+++ b/.agents/skills/mcp-server-patterns/agents/openai.yaml@@ -0,0 +1,7 @@+interface:+ display_name: "MCP Server Patterns"+ short_description: "MCP server tools, resources, and prompts"+ brand_color: "#0EA5E9"+ default_prompt: "Use $mcp-server-patterns to build MCP tools, resources, and prompts."+policy:+ allow_implicit_invocation: truediff --git a/.agents/skills/nextjs-turbopack/SKILL.md b/.agents/skills/nextjs-turbopack/SKILL.mdindex 8e5287102..01b9c391f 100644--- a/.agents/skills/nextjs-turbopack/SKILL.md+++ b/.agents/skills/nextjs-turbopack/SKILL.md@@ -1,7 +1,6 @@---name: nextjs-turbopackdescription: Next.js 16+ and Turbopack — incremental bundling, FS caching, dev speed, and when to use Turbopack vs webpack.-origin: ECC---# Next.js and Turbopackdiff --git a/.agents/skills/nextjs-turbopack/agents/openai.yaml b/.agents/skills/nextjs-turbopack/agents/openai.yamlindex 61369bf19..b48ba47f6 100644--- a/.agents/skills/nextjs-turbopack/agents/openai.yaml+++ b/.agents/skills/nextjs-turbopack/agents/openai.yaml@@ -1,7 +1,7 @@interface:display_name: "Next.js Turbopack"- short_description: "Next.js 16+ and Turbopack dev bundler"+ short_description: "Next.js and Turbopack workflow guidance"brand_color: "#000000"- default_prompt: "Next.js dev, Turbopack, or bundle optimization"+ default_prompt: "Use $nextjs-turbopack to work through Next.js and Turbopack decisions."policy:allow_implicit_invocation: truediff --git a/.agents/skills/product-capability/SKILL.md b/.agents/skills/product-capability/SKILL.mdindex 4e3509a4b..7831d85d8 100644--- a/.agents/skills/product-capability/SKILL.md+++ b/.agents/skills/product-capability/SKILL.md@@ -1,7 +1,6 @@---name: product-capabilitydescription: Translate PRD intent, roadmap asks, or product discussions into an implementation-ready capability plan that exposes constraints, invariants, interfaces, and unresolved decisions before multi-service work starts. Use when the user needs an ECC-native PRD-to-SRS lane instead of vague planning prose.-origin: ECC---# Product Capabilitydiff --git a/.agents/skills/product-capability/agents/openai.yaml b/.agents/skills/product-capability/agents/openai.yamlnew file mode 100644index 000000000..dcace132f--- /dev/null+++ b/.agents/skills/product-capability/agents/openai.yaml@@ -0,0 +1,7 @@+interface:+ display_name: "Product Capability"+ short_description: "Implementation-ready product capability plans"+ brand_color: "#0EA5E9"+ default_prompt: "Use $product-capability to turn product intent into an implementation plan."+policy:+ allow_implicit_invocation: truediff --git a/.agents/skills/security-review/SKILL.md b/.agents/skills/security-review/SKILL.mdindex af848b95e..e91e05859 100644--- a/.agents/skills/security-review/SKILL.md+++ b/.agents/skills/security-review/SKILL.md@@ -1,7 +1,6 @@---name: security-reviewdescription: Use this skill when adding authentication, handling user input, working with secrets, creating API endpoints, or implementing payment/sensitive features. Provides comprehensive security checklist and patterns.-origin: ECC---# Security Review Skilldiff --git a/.agents/skills/security-review/agents/openai.yaml b/.agents/skills/security-review/agents/openai.yamlindex 9af830238..83739c87c 100644--- a/.agents/skills/security-review/agents/openai.yaml+++ b/.agents/skills/security-review/agents/openai.yaml@@ -1,7 +1,7 @@interface:display_name: "Security Review"- short_description: "Comprehensive security checklist and vulnerability detection"+ short_description: "Security checklist and vulnerability review"brand_color: "#EF4444"- default_prompt: "Run security checklist: secrets, input validation, injection prevention"+ default_prompt: "Use $security-review to review sensitive code with the security checklist."policy:allow_implicit_invocation: truediff --git a/.agents/skills/strategic-compact/SKILL.md b/.agents/skills/strategic-compact/SKILL.mdindex 67bbb31ee..2e37f40a1 100644--- a/.agents/skills/strategic-compact/SKILL.md+++ b/.agents/skills/strategic-compact/SKILL.md@@ -1,7 +1,6 @@---name: strategic-compactdescription: Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction.-origin: ECC---# Strategic Compact Skilldiff --git a/.agents/skills/strategic-compact/agents/openai.yaml b/.agents/skills/strategic-compact/agents/openai.yamlindex 19ecabf8a..1c53ef51b 100644--- a/.agents/skills/strategic-compact/agents/openai.yaml+++ b/.agents/skills/strategic-compact/agents/openai.yaml@@ -2,6 +2,6 @@ interface:display_name: "Strategic Compact"short_description: "Context management via strategic compaction"brand_color: "#14B8A6"- default_prompt: "Suggest task boundary compaction for context management"+ default_prompt: "Use $strategic-compact to choose a useful context compaction boundary."policy:allow_implicit_invocation: truediff --git a/.agents/skills/tdd-workflow/SKILL.md b/.agents/skills/tdd-workflow/SKILL.mdindex 63c6309e9..7e61dcef0 100644--- a/.agents/skills/tdd-workflow/SKILL.md+++ b/.agents/skills/tdd-workflow/SKILL.md@@ -1,7 +1,6 @@---name: tdd-workflowdescription: Use this skill when writing new features, fixing bugs, or refactoring code. Enforces test-driven development with 80%+ coverage including unit, integration, and E2E tests.-origin: ECC---# Test-Driven Development Workflowdiff --git a/.agents/skills/tdd-workflow/agents/openai.yaml b/.agents/skills/tdd-workflow/agents/openai.yamlindex 425c7d1c5..7f6355cf9 100644--- a/.agents/skills/tdd-workflow/agents/openai.yaml+++ b/.agents/skills/tdd-workflow/agents/openai.yaml@@ -1,7 +1,7 @@interface:display_name: "TDD Workflow"- short_description: "Test-driven development with 80%+ coverage"+ short_description: "Test-driven development with coverage gates"brand_color: "#22C55E"- default_prompt: "Follow TDD: write tests first, implement, verify 80%+ coverage"+ default_prompt: "Use $tdd-workflow to drive the change with tests before implementation."policy:allow_implicit_invocation: truediff --git a/.agents/skills/verification-loop/SKILL.md b/.agents/skills/verification-loop/SKILL.mdindex 1933545d5..1c0904925 100644--- a/.agents/skills/verification-loop/SKILL.md+++ b/.agents/skills/verification-loop/SKILL.md@@ -1,7 +1,6 @@---name: verification-loopdescription: "A comprehensive verification system for Claude Code sessions."-origin: ECC---# Verification Loop Skilldiff --git a/.agents/skills/verification-loop/agents/openai.yaml b/.agents/skills/verification-loop/agents/openai.yamlindex 644a9ad53..e1d72dd92 100644--- a/.agents/skills/verification-loop/agents/openai.yaml+++ b/.agents/skills/verification-loop/agents/openai.yaml@@ -1,7 +1,7 @@interface:display_name: "Verification Loop"- short_description: "Build, test, lint, typecheck verification"+ short_description: "Build, test, lint, and typecheck verification"brand_color: "#10B981"- default_prompt: "Run verification: build, test, lint, typecheck, security"+ default_prompt: "Use $verification-loop to run build, test, lint, and typecheck verification."policy:allow_implicit_invocation: truediff --git a/.agents/skills/video-editing/SKILL.md b/.agents/skills/video-editing/SKILL.mdindex fb47d9adc..8353a968f 100644--- a/.agents/skills/video-editing/SKILL.md+++ b/.agents/skills/video-editing/SKILL.md@@ -1,7 +1,6 @@---name: video-editingdescription: AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.-origin: ECC---# Video Editingdiff --git a/.agents/skills/video-editing/agents/openai.yaml b/.agents/skills/video-editing/agents/openai.yamlindex e943e0190..4dadcf8e8 100644--- a/.agents/skills/video-editing/agents/openai.yaml+++ b/.agents/skills/video-editing/agents/openai.yaml@@ -1,7 +1,7 @@interface:display_name: "Video Editing"- short_description: "AI-assisted video editing for real footage"+ short_description: "AI-assisted editing for real footage"brand_color: "#EF4444"- default_prompt: "Edit video using AI-assisted pipeline: organize, cut, compose, generate assets, polish"+ default_prompt: "Use $video-editing to plan an AI-assisted edit for real footage."policy:allow_implicit_invocation: truediff --git a/.agents/skills/x-api/SKILL.md b/.agents/skills/x-api/SKILL.mdindex 9100664ce..7fb880f71 100644--- a/.agents/skills/x-api/SKILL.md+++ b/.agents/skills/x-api/SKILL.md@@ -1,7 +1,6 @@---name: x-apidescription: X/Twitter API integration for posting tweets, threads, reading timelines, search, and analytics. Covers OAuth auth patterns, rate limits, and platform-native content posting. Use when the user wants to interact with X programmatically.-origin: ECC---# X APIdiff --git a/.agents/skills/x-api/agents/openai.yaml b/.agents/skills/x-api/agents/openai.yamlindex 2875958fb..1aa2982c7 100644--- a/.agents/skills/x-api/agents/openai.yaml+++ b/.agents/skills/x-api/agents/openai.yaml@@ -1,7 +1,7 @@interface:display_name: "X API"- short_description: "X/Twitter API integration for posting, threads, and analytics"+ short_description: "X API posting, timelines, and analytics"brand_color: "#000000"- default_prompt: "Use X API to post tweets, threads, or retrieve timeline and search data"+ default_prompt: "Use $x-api to build X API posting, timeline, or analytics workflows."policy:allow_implicit_invocation: truediff --git a/tests/ci/codex-skill-surface.test.js b/tests/ci/codex-skill-surface.test.jsnew file mode 100644index 000000000..d44403b39--- /dev/null+++ b/tests/ci/codex-skill-surface.test.js@@ -0,0 +1,121 @@+#!/usr/bin/env node+/**+ * Validate the Codex-facing .agents/skills surface.+ */++const assert = require('assert');+const fs = require('fs');+const path = require('path');++const REPO_ROOT = path.join(__dirname, '..', '..');+const CODEX_SKILLS_DIR = path.join(REPO_ROOT, '.agents', 'skills');+const ALLOWED_FRONTMATTER_KEYS = new Set([+ 'allowed-tools',+ 'description',+ 'license',+ 'metadata',+ 'name',+]);++function test(name, fn) {+ try {+ fn();+ console.log(` ✓ ${name}`);+ return true;+ } catch (error) {+ console.log(` ✗ ${name}`);+ console.log(` Error: ${error.message}`);+ return false;+ }+}++function listSkillDirs() {+ return fs.readdirSync(CODEX_SKILLS_DIR, { withFileTypes: true })+ .filter(entry => entry.isDirectory())+ .map(entry => entry.name)+ .sort();+}++function parseFrontmatter(skillName) {+ const skillPath = path.join(CODEX_SKILLS_DIR, skillName, 'SKILL.md');+ const content = fs.readFileSync(skillPath, 'utf8');+ const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);+ assert.ok(match, `${skillName}/SKILL.md is missing frontmatter`);++ const frontmatter = {};+ for (const line of match[1].split(/\r?\n/)) {+ const topLevelKey = line.match(/^([A-Za-z0-9_-]+):/);+ if (topLevelKey) {+ frontmatter[topLevelKey[1]] = line.slice(topLevelKey[1].length + 1).trim();+ }+ }+ return frontmatter;+}++function parseQuotedYamlValue(source, key) {+ const match = source.match(new RegExp(`^\\s{2}${key}:\\s*(.+?)\\s*$`, 'm'));+ if (!match) return '';++ const raw = match[1].trim();+ if (+ (raw.startsWith('"') && raw.endsWith('"')) ||+ (raw.startsWith("'") && raw.endsWith("'"))+ ) {+ return raw.slice(1, -1);+ }+ return raw;+}++function run() {+ console.log('\n=== Testing Codex skill surface ===\n');++ let passed = 0;+ let failed = 0;+ const skillDirs = listSkillDirs();++ if (test('Codex skill directory is populated', () => {+ assert.ok(skillDirs.length > 0, 'Expected at least one .agents/skills entry');+ })) passed++; else failed++;++ if (test('SKILL.md frontmatter matches Codex validator expectations', () => {+ for (const skillDir of skillDirs) {+ const frontmatter = parseFrontmatter(skillDir);+ const keys = Object.keys(frontmatter).sort();+ const unexpected = keys.filter(key => !ALLOWED_FRONTMATTER_KEYS.has(key));+ assert.deepStrictEqual(unexpected, [], `${skillDir}/SKILL.md has unsupported keys`);+ assert.strictEqual(frontmatter.name, skillDir, `${skillDir}/SKILL.md name must match folder`);+ assert.ok(frontmatter.description, `${skillDir}/SKILL.md needs a description`);+ }+ })) passed++; else failed++;++ if (test('agents/openai.yaml exists and names the skill in default_prompt', () => {+ for (const skillDir of skillDirs) {+ const metadataPath = path.join(CODEX_SKILLS_DIR, skillDir, 'agents', 'openai.yaml');+ assert.ok(fs.existsSync(metadataPath), `${skillDir} is missing agents/openai.yaml`);++ const metadata = fs.readFileSync(metadataPath, 'utf8');+ const displayName = parseQuotedYamlValue(metadata, 'display_name');+ const shortDescription = parseQuotedYamlValue(metadata, 'short_description');+ const defaultPrompt = parseQuotedYamlValue(metadata, 'default_prompt');++ assert.ok(displayName, `${skillDir}/agents/openai.yaml needs display_name`);+ assert.ok(shortDescription, `${skillDir}/agents/openai.yaml needs short_description`);+ assert.ok(defaultPrompt, `${skillDir}/agents/openai.yaml needs default_prompt`);+ assert.ok(+ shortDescription.length >= 25 && shortDescription.length <= 64,+ `${skillDir}/agents/openai.yaml short_description must be 25-64 characters`+ );+ assert.ok(+ defaultPrompt.includes(`$${skillDir}`),+ `${skillDir}/agents/openai.yaml default_prompt must mention $${skillDir}`+ );+ }+ })) passed++; else failed++;++ console.log(`\nPassed: ${passed}`);+ console.log(`Failed: ${failed}`);++ process.exit(failed > 0 ? 1 : 0);+}++run();