Codex skills

.github/PULL_REQUEST_TEMPLATE.md

@@ -9,12 +9,12 @@
 
 - [ ] SKILL.md has valid YAML frontmatter with all required fields
 - [ ] Skill ID matches the directory name
-- [ ] Category is one of: productivity, development, communication, writing, research, other
+- [ ] Category is one of the supported Skills Store categories in CONTRIBUTING.md
+- [ ] Description starts with "Use this skill when..." and clearly describes the trigger intent
 - [ ] Instructions are clear and self-contained
 - [ ] Instructions are under 4000 tokens
 - [ ] No external URLs referenced in instructions
 - [ ] Tested the skill with an AI agent and it produces good results
-- [ ] Added usage examples in the frontmatter
 
 ### Testing
 

.github/workflows/validate-skill.yml

@@ -71,6 +71,7 @@ jobs:
               "Data & AI"
               "Business"
               "Development"
+              "OpenAI"
               "Tools"
             )
             VALID=0
@@ -113,7 +114,7 @@ jobs:
 
             # Check instruction length (rough token estimate: ~4 chars per token)
             BODY_LENGTH=$(echo "$BODY" | wc -c)
-            MAX_CHARS=16000  # ~4000 tokens
+            MAX_CHARS=24000  # ~6000 tokens
             if [ "$BODY_LENGTH" -gt "$MAX_CHARS" ]; then
               echo "::error file=$file::Instructions too long ($BODY_LENGTH chars, max $MAX_CHARS)"
               ERRORS=$((ERRORS + 1))

CONTRIBUTING.md

@@ -29,10 +29,6 @@ description: A concise description of what this skill does (shown to the LLM).
 category: Development
 author: your-github-username
 version: 1.0.0
-requires: []
-examples:
-  - Example usage prompt 1
-  - Example usage prompt 2
 ---
 
 Your skill instructions go here. Write in natural language.
@@ -56,8 +52,6 @@ Include any specific formatting, steps, or constraints.
 |-------|------|-------------|
 | `author` | string | Your GitHub username |
 | `version` | string | Semantic version (default: 1.0.0) |
-| `requires` | array | Input requirements: `document`, `text`, `thread` |
-| `examples` | array | Example prompts that would trigger this skill |
 
 ### Categories
 
@@ -72,16 +66,17 @@ Include any specific formatting, steps, or constraints.
 - **Data & AI**
 - **Business**
 - **Development**
+- **OpenAI**
 - **Tools**
 
 ## Guidelines
 
 1. **Keep instructions clear and specific** -- The LLM needs to understand exactly what to do
 2. **Don't include prompt injection** -- Instructions must not attempt to override system prompts
 3. **Don't reference external URLs** -- Skills should be self-contained
-4. **Keep instructions under 4000 tokens** -- Shorter is better for performance
+4. **Keep instructions under 6000 tokens** -- Shorter is better for performance
 5. **Test your skill** -- Make sure the instructions produce good results
-6. **Include examples** -- Help users understand when to use your skill
+6. **Make the description trigger-focused** -- Start with "Use this skill when..." and describe the user intent that should activate it.
 
 ## Review Process
 

README.md

@@ -65,6 +65,7 @@ Common categories you’ll see:
 - Data & AI
 - Business
 - Development
+- OpenAI
 - Tools
 
 Use the most specific, user-friendly category that matches the skill’s primary intent. If a skill spans multiple domains, pick the category users would most likely search.

skills/ab-test-setup/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "A/B Test Setup"
+  short_description: "Setting up, improving, or auditing analytics measurement for experiments, conversion tracking, event instrumentation, funnel analysis, or A/B test readiness."
+  default_prompt: "Set up, improve, or audit analytics measurement for experiments, conversion tracking, event instrumentation, funnel analysis, or A/B test readiness."

skills/accessibility/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Accessibility"
+  short_description: "Implementing or reviewing VS Code accessibility surfaces, including help dialogs, accessible views, verbosity settings, accessibility signals, ARIA alerts, keyboard navigation,..."
+  default_prompt: "Implement or review VS Code accessibility surfaces, including help dialogs, accessible views, verbosity settings, accessibility signals, ARIA alerts, keyboard navigation."

skills/add-malli-schemas/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Add Malli Schemas"
+  short_description: "Introducing or evolving Malli schemas in Clojure codebases, combining schema design, validation coverage, migration safety, and clear contract documentation."
+  default_prompt: "Introduce or evolving Malli schemas in Clojure codebases, combining schema design, validation coverage, migration safety, and clear contract documentation."

skills/add-provider-doc/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Add Provider Doc"
+  short_description: "Producing provider documentation that must be accurate, actionable, and support-friendly, including setup, usage, limits, troubleshooting, and release-ready structure."
+  default_prompt: "Produce provider documentation that is accurate, actionable, and support-friendly, including setup, usage, limits, troubleshooting, and release-ready structure."

skills/add-uint-support/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Add UInt Support"
+  short_description: "Introducing unsigned integer handling into an existing codebase, covering parsing, validation, storage, serialization, APIs, arithmetic boundaries, and overflow compatibility..."
+  default_prompt: "Introduce unsigned integer handling into an existing codebase, covering parsing, validation, storage, serialization, APIs, arithmetic boundaries, and overflow compatibility."

skills/agent-load-balancer/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Agent Load Balancer"
+  short_description: "Designing load balancing or traffic distribution for AI agents, including routing policies, reliability targets, latency control, throughput scaling, and demand-aware failover."
+  default_prompt: "Design load balancing or traffic distribution for AI agents, including routing policies, reliability targets, latency control, throughput scaling, and demand-aware failover."

skills/agent-performance-analyzer/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Agent Performance Analyzer"
+  short_description: "Analyzing AI agent performance with latency, success rate, cost, quality, throughput, and failure signals to identify bottlenecks and improvement opportunities."
+  default_prompt: "Analyze AI agent performance with latency, success rate, cost, quality, throughput, and failure signals to identify bottlenecks and improvement opportunities."

skills/ai-product/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "AI Product"
+  short_description: "Planning, shipping, or improving AI products, including product strategy, user workflows, evaluation loops, model capability boundaries, UX risks, and release tradeoffs."
+  default_prompt: "Plan, shipping, or improving AI products, including product strategy, user workflows, evaluation loops, model capability boundaries, UX risks, and release tradeoffs."

skills/airbnb-search/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Airbnb Search"
+  short_description: "Comparing Airbnb-style accommodation options or short-term stays, using prices, ratings, locations, availability context, direct links, and recommendation tradeoffs."
+  default_prompt: "Compare Airbnb-style accommodation options or short-term stays, using prices, ratings, locations, availability context, direct links, and recommendation tradeoffs."

skills/airflow-dag-patterns/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Airflow DAG Patterns"
+  short_description: "Designing or reviewing Apache Airflow DAGs for scheduling, retries, task dependencies, idempotency, backfills, sensors, and production reliability."
+  default_prompt: "Design or reviewing Apache Airflow DAGs for scheduling, retries, task dependencies, idempotency, backfills, sensors, and production reliability."

skills/analytics-events/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Analytics Events"
+  short_description: "Keeping analytics instrumentation accurate, consistent, and release-ready across event definitions, tracking plans, schemas, implementation, QA, and governance."
+  default_prompt: "Keep analytics instrumentation accurate, consistent, and release-ready across event definitions, tracking plans, schemas, implementation, QA, and governance."

skills/anndata/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "AnnData"
+  short_description: "Working with AnnData in scalable single-cell workflows, including backed mode, layers, obs/var metadata, sparse matrices, batch processing, and Scanpy-style pipelines."
+  default_prompt: "Work with AnnData in scalable single-cell workflows, including backed mode, layers, obs/var metadata, sparse matrices, batch processing, and Scanpy-style pipelines."

skills/arm-cortex-expert/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Arm Cortex Expert"
+  short_description: "Designing or optimizing embedded firmware for ARM Cortex MCUs, including memory layout, timing, interrupts, peripherals, low-power behavior, and hardware-adjacent debugging."
+  default_prompt: "Design or optimizing embedded firmware for ARM Cortex MCUs, including memory layout, timing, interrupts, peripherals, low-power behavior, and hardware-adjacent debugging."

skills/assess-risk/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Assess Risk"
+  short_description: "Reviewing Apache ShardingSphere pull requests for root-cause fixes, side effects, regression risk, merge readiness, and committer-tone change requests."
+  default_prompt: "Review Apache ShardingSphere pull requests for root-cause fixes, side effects, regression risk, merge readiness, and committer-tone change requests."

skills/audit-logging/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Audit Logging"
+  short_description: "Implementing database audit logging, change tracking, compliance trails, trigger-based logs, app-level audit events, or CDC-backed history tables."
+  default_prompt: "Implement database audit logging, change tracking, compliance trails, trigger-based logs, app-level audit events, or CDC-backed history tables."

skills/authoring-skills/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Authoring Skills"
+  short_description: "Creating or modifying agent skills, especially SKILL.md frontmatter, trigger descriptions, naming conventions, skill versus AGENTS.md boundaries, and local skill structure."
+  default_prompt: "Create or modifying agent skills, especially SKILL.md frontmatter, trigger descriptions, naming conventions, skill versus AGENTS.md boundaries, and local skill structure."

skills/azure-sdk-mgmt-pr-review/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Azure Sdk Mgmt Pr Review"
+  short_description: "Reviewing Azure SDK management-plane pull requests for API compatibility, naming conventions, generated-code expectations, breaking changes, and SDK quality standards."
+  default_prompt: "Review Azure SDK management-plane pull requests for API compatibility, naming conventions, generated-code expectations, breaking changes, and SDK quality standards."

skills/bap578-agent-economy/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "BAP-578 Agent Economy"
+  short_description: "Designing, modeling, or operating BAP-578 agent economies where NFAs transact, collaborate, compete, provide services, handle funding, build reputation, or align incentives."
+  default_prompt: "Design, modeling, or operating BAP-578 agent economies where NFAs transact, collaborate, compete, provide services, handle funding, build reputation, or align incentives."

skills/bap578-analytics/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "BAP-578 Analytics & Indexing"
+  short_description: "Defining metrics, building indexers, creating dashboards, or generating reports for BAP-578 Non-Fungible Agents from minting, vault funding, treasury, engagement, and event data."
+  default_prompt: "Define metrics, building indexers, creating dashboards, or generating reports for BAP-578 Non-Fungible Agents from minting, vault funding, treasury, engagement, and event data."

skills/bap578-business/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "BAP-578 Business & Monetization"
+  short_description: "Planning monetization, pricing, treasury flows, growth strategy, unit economics, go-to-market, or commercial sustainability for BAP-578 Non-Fungible Agents."
+  default_prompt: "Plan monetization, pricing, treasury flows, growth strategy, unit economics, go-to-market, or commercial sustainability for BAP-578 Non-Fungible Agents."

skills/bap578-deploy/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "BAP-578 Deployment"
+  short_description: "Deploying, verifying, configuring, or validating BAP-578 Non-Fungible Agent contracts on BNB Chain testnet or mainnet, from environment setup through post-deployment checks."
+  default_prompt: "Deploy, verifying, configuring, or validating BAP-578 Non-Fungible Agent contracts on BNB Chain testnet or mainnet, from environment setup through post-deployment checks."

skills/bap578-logic-contracts/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "BAP-578 Logic Contracts"
+  short_description: "Designing, building, deploying, binding, or reviewing logic contracts that define autonomous on-chain behavior for BAP-578 Non-Fungible Agents."
+  default_prompt: "Design, building, deploying, binding, or reviewing logic contracts that define autonomous on-chain behavior for BAP-578 Non-Fungible Agents."

skills/bap578-metadata-design/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "BAP-578 Metadata & Persona Design"
+  short_description: "Crafting BAP-578 AgentMetadata identity data, including personas, experience fields, vault schemas, voice profiles, metadata URIs, vault integrity, and rich verifiable agent..."
+  default_prompt: "Craft BAP-578 AgentMetadata identity data, including personas, experience fields, vault schemas, voice profiles, metadata URIs, vault integrity, and rich verifiable agent."

skills/bap578-scanner/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "BAP-578 On-Chain Scanner"
+  short_description: "Reading, verifying, scanning, querying, indexing, or monitoring BAP-578 agent data directly from BNB Chain, including metadata, event history, vault integrity, and bulk RPC..."
+  default_prompt: "Read, verifying, scanning, querying, indexing, or monitoring BAP-578 agent data directly from BNB Chain, including metadata, event history, vault integrity, and bulk RPC."

skills/bap578-security-audit/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "BAP-578 Security Audit"
+  short_description: "Auditing, hardening, or verifying the security posture of BAP-578 Non-Fungible Agent deployments, including threat models, NFA-specific vulnerabilities, and remediation guidance."
+  default_prompt: "Audit, hardening, or verifying the security posture of BAP-578 Non-Fungible Agent deployments, including threat models, NFA-specific vulnerabilities, and remediation guidance."

skills/bap578-testing/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "BAP-578 Testing"
+  short_description: "Writing, running, debugging, or extending BAP-578 Non-Fungible Agent tests, including infrastructure setup, function coverage, edge cases, upgrades, gas profiling, and Hardhat..."
+  default_prompt: "Write, running, debugging, or extending BAP-578 Non-Fungible Agent tests, including infrastructure setup, function coverage, edge cases, upgrades, gas profiling, and Hardhat."

skills/bap578-upgrade/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "BAP-578 Contract Upgrade"
+  short_description: "Planning, implementing, testing, or executing safe BAP-578 contract upgrades with the UUPS proxy pattern, including storage layout discipline, V2 implementations, deployment, and..."
+  default_prompt: "Plan, implementing, testing, or executing safe BAP-578 contract upgrades with the UUPS proxy pattern, including storage layout discipline, V2 implementations, deployment, and."

skills/bap578/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "BAP-578 Non-Fungible Agents"
+  short_description: "Users ask about BAP-578, Non-Fungible Agents, or hands-on engineering for the BAP-578 reference implementation on BNB Chain, including identity, memory, learning proofs, vaults, AI..."
+  default_prompt: "Explain or work on BAP-578, Non-Fungible Agents, or hands-on engineering for the BAP-578 reference implementation on BNB Chain, including identity, memory, learning proofs, vaults, AI."

skills/binance/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Binance"
+  short_description: "Building, evaluating, or tuning a Polymarket BTC 1h Up/Down trading strategy that uses Binance market data as the resolution or pricing anchor."
+  default_prompt: "Build, evaluating, or tuning a Polymarket BTC 1h Up/Down trading strategy that uses Binance market data as the resolution or pricing anchor."

skills/bonero-miner/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Bonero Miner"
+  short_description: "Setting up or troubleshooting Bonero mining, wallets, daemons, RandomX CPU mining, or Monero-style private cryptocurrency workflows for AI agents."
+  default_prompt: "Set up or troubleshooting Bonero mining, wallets, daemons, RandomX CPU mining, or Monero-style private cryptocurrency workflows for AI agents."

skills/book-translation/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Book Translation"
+  short_description: "Translating a book, chapter, or long-form document into another language while preserving structure, formatting, terminology consistency, and document continuity."
+  default_prompt: "Translate a book, chapter, or long-form document into another language while preserving structure, formatting, terminology consistency, and document continuity."

skills/browser-extension-developer/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Browser Extension Developer"
+  short_description: "Building or reviewing browser extensions that need extension-specific guidance for runtime boundaries, permissions, content scripts, background scripts, messaging, storage,..."
+  default_prompt: "Build or reviewing browser extensions that need extension-specific guidance for runtime boundaries, permissions, content scripts, background scripts, messaging, storage."

skills/cairo-vulnerability-scanner/agents/interface.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Cairo Vulnerability Scanner"
+  short_description: "Scanning Cairo or StarkNet smart contracts for StarkNet-specific vulnerabilities such as felt252 arithmetic overflow, L1-L2 messaging flaws, address conversion bugs, or signature..."
+  default_prompt: "Scan Cairo or StarkNet smart contracts for StarkNet-specific vulnerabilities such as felt252 arithmetic overflow, L1-L2 messaging flaws, address conversion bugs, or signature."