Unblock daily skill-optimizer runs by adding root SKILL surface docs, committed config, and early workflow preflight

.github/workflows/daily-skill-optimizer.md

@@ -34,6 +34,14 @@ jobs:
         with:
           node-version: "24"
 
+      - name: Validate SKILL.md exists
+        shell: bash
+        run: |
+          if [ ! -f SKILL.md ]; then
+            echo "::error file=SKILL.md::SKILL.md is required by skill-optimizer. See .skill-optimizer/skill-optimizer.json for setup instructions."
+            exit 1
+          fi
+
       - name: Run skill-optimizer
         id: run_skill_optimizer
         shell: bash

.skill-optimizer/skill-optimizer.json

@@ -0,0 +1,37 @@
+{
+  "name": "gh-aw",
+  "target": {
+    "surface": "prompt",
+    "repoPath": "..",
+    "skill": "../SKILL.md"
+  },
+  "benchmark": {
+    "format": "pi",
+    "timeout": 240000,
+    "taskGeneration": {
+      "enabled": true,
+      "maxTasks": 10,
+      "outputDir": "."
+    },
+    "models": [
+      {
+        "id": "openrouter/anthropic/claude-sonnet-4.6",
+        "name": "Claude Sonnet 4.6",
+        "tier": "flagship"
+      }
+    ],
+    "output": {
+      "dir": "../benchmark-results"
+    },
+    "verdict": {
+      "perModelFloor": 0.6,
+      "targetWeightedAverage": 0.8
+    }
+  },
+  "optimize": {
+    "model": "openrouter/anthropic/claude-sonnet-4.6",
+    "allowedPaths": ["SKILL.md"],
+    "validation": [],
+    "maxIterations": 1
+  }
+}

AGENTS.md

@@ -28,6 +28,14 @@ GitHub Agentic Workflows is a Go-based GitHub CLI extension for writing agentic
 
 Each skill provides focused guidance on specific topics. Reference them only as needed rather than loading everything upfront.
 
+## Skill Optimizer Configuration
+
+The daily skill-optimizer workflow uses the committed config at:
+
+- `.skill-optimizer/skill-optimizer.json`
+
+When tuning optimizer behavior (models, maxTasks, maxIterations, pass-rate target), update this file directly in a PR so changes are reviewable.
+
 ## Critical Requirements
 
 ### ⚠️ MANDATORY: Always Create a Pull Request ⚠️

SKILL.md

@@ -0,0 +1,39 @@
+# gh-aw Prompt Surface
+
+This repository builds **gh-aw** (GitHub Agentic Workflows), a GitHub CLI extension for writing workflows in markdown and compiling them to GitHub Actions.
+
+## What this surface does
+
+- Converts markdown workflow specs (`.md`) into compiled lock files (`.lock.yml`)
+- Supports multiple AI engines (`copilot`, `claude`, `codex`, `custom`)
+- Integrates tools, including GitHub MCP servers and safe-output tooling
+- Provides CLI commands to compile, run, inspect, and audit workflows
+
+## Key concepts
+
+1. **Workflow compilation**: edit workflow markdown, then recompile lock files
+2. **Engine selection**: set `engine` in frontmatter to control runtime agent behavior
+3. **MCP tools**: configure GitHub/MCP toolsets in frontmatter for repository operations
+4. **Safe outputs**: workflow-safe issue/comment output paths and constraints
+
+## Representative usage examples
+
+```bash
+# Compile markdown workflows to lock files
+gh aw compile
+
+# Run a workflow manually
+gh aw run .github/workflows/daily-skill-optimizer.md
+
+# Inspect MCP server usage in workflows
+gh aw mcp list
+gh aw mcp inspect daily-skill-optimizer
+
+# Audit a workflow run
+gh aw audit 24814681146
+```
+
+## Where to learn more in this repo
+
+- `/AGENTS.md` for development/agent workflow conventions
+- `/skills/*/SKILL.md` for focused domain guidance (GitHub MCP, docs, errors, etc.)