From fa9813daa431cc7858bb67b69b53d6e22049fea5 Mon Sep 17 00:00:00 2001 From: Steve Beaulac Date: Tue, 6 Oct 2026 14:16:57 -0400 Subject: [PATCH] feat(skills): add openai agent interface configs for all skills Declare display_name, short_description, and disable implicit invocation for each skill via agents/openai.yaml. Also fix stale /setup-matt-pocock-skills reference in implement-spec to /setup-skills. --- skills/engineering/code-quality-review/agents/openai.yaml | 5 +++++ skills/engineering/dual-review/agents/openai.yaml | 5 +++++ skills/engineering/feedback-bundle/agents/openai.yaml | 5 +++++ skills/engineering/implement-spec/SKILL.md | 2 +- skills/engineering/orchestrate-herdr/agents/openai.yaml | 5 +++++ skills/engineering/recipe-diagrams/agents/openai.yaml | 5 +++++ skills/engineering/security-audit/agents/openai.yaml | 5 +++++ skills/engineering/worktrees/agents/openai.yaml | 5 +++++ .../engineering/write-discoverable-code/agents/openai.yaml | 5 +++++ skills/misc/bro/agents/openai.yaml | 5 +++++ skills/misc/show-me/agents/openai.yaml | 5 +++++ skills/misc/visual-verification/agents/openai.yaml | 5 +++++ skills/personal/arch-maintenance/agents/openai.yaml | 5 +++++ skills/personal/arch-troubleshooting/agents/openai.yaml | 5 +++++ skills/pstack/bugfix-regression-test/agents/openai.yaml | 5 +++++ skills/pstack/fix-merge-conflicts/agents/openai.yaml | 5 +++++ skills/pstack/how/agents/openai.yaml | 5 +++++ skills/pstack/interrogate/agents/openai.yaml | 5 +++++ skills/pstack/reflect/agents/openai.yaml | 5 +++++ skills/pstack/unslop/agents/openai.yaml | 5 +++++ skills/pstack/why/agents/openai.yaml | 5 +++++ .../effective-agent-skills/agents/openai.yaml | 5 +++++ skills/thinking-and-docs/brain-to-docs/agents/openai.yaml | 5 +++++ skills/thinking-and-docs/next-decision/agents/openai.yaml | 5 +++++ skills/thinking-and-docs/prompt-me/agents/openai.yaml | 5 +++++ skills/thinking-and-docs/save-idea/agents/openai.yaml | 5 +++++ 26 files changed, 126 insertions(+), 1 deletion(-) create mode 100644 skills/engineering/code-quality-review/agents/openai.yaml create mode 100644 skills/engineering/dual-review/agents/openai.yaml create mode 100644 skills/engineering/feedback-bundle/agents/openai.yaml create mode 100644 skills/engineering/orchestrate-herdr/agents/openai.yaml create mode 100644 skills/engineering/recipe-diagrams/agents/openai.yaml create mode 100644 skills/engineering/security-audit/agents/openai.yaml create mode 100644 skills/engineering/worktrees/agents/openai.yaml create mode 100644 skills/engineering/write-discoverable-code/agents/openai.yaml create mode 100644 skills/misc/bro/agents/openai.yaml create mode 100644 skills/misc/show-me/agents/openai.yaml create mode 100644 skills/misc/visual-verification/agents/openai.yaml create mode 100644 skills/personal/arch-maintenance/agents/openai.yaml create mode 100644 skills/personal/arch-troubleshooting/agents/openai.yaml create mode 100644 skills/pstack/bugfix-regression-test/agents/openai.yaml create mode 100644 skills/pstack/fix-merge-conflicts/agents/openai.yaml create mode 100644 skills/pstack/how/agents/openai.yaml create mode 100644 skills/pstack/interrogate/agents/openai.yaml create mode 100644 skills/pstack/reflect/agents/openai.yaml create mode 100644 skills/pstack/unslop/agents/openai.yaml create mode 100644 skills/pstack/why/agents/openai.yaml create mode 100644 skills/skill-authoring/effective-agent-skills/agents/openai.yaml create mode 100644 skills/thinking-and-docs/brain-to-docs/agents/openai.yaml create mode 100644 skills/thinking-and-docs/next-decision/agents/openai.yaml create mode 100644 skills/thinking-and-docs/prompt-me/agents/openai.yaml create mode 100644 skills/thinking-and-docs/save-idea/agents/openai.yaml diff --git a/skills/engineering/code-quality-review/agents/openai.yaml b/skills/engineering/code-quality-review/agents/openai.yaml new file mode 100644 index 0000000..d4bb952 --- /dev/null +++ b/skills/engineering/code-quality-review/agents/openai.yaml @@ -0,0 +1,5 @@ +interface: + display_name: "Thermo-Nuclear Code Quality Review" + short_description: "Strict review of abstractions, large files, and condition complexity" +policy: + allow_implicit_invocation: false diff --git a/skills/engineering/dual-review/agents/openai.yaml b/skills/engineering/dual-review/agents/openai.yaml new file mode 100644 index 0000000..4cb3474 --- /dev/null +++ b/skills/engineering/dual-review/agents/openai.yaml @@ -0,0 +1,5 @@ +interface: + display_name: "Dual Review" + short_description: "Parallel correctness, security, and maintainability review" +policy: + allow_implicit_invocation: false diff --git a/skills/engineering/feedback-bundle/agents/openai.yaml b/skills/engineering/feedback-bundle/agents/openai.yaml new file mode 100644 index 0000000..f35d082 --- /dev/null +++ b/skills/engineering/feedback-bundle/agents/openai.yaml @@ -0,0 +1,5 @@ +interface: + display_name: "Feedback Bundle" + short_description: "File Gitea issues with commit links and attached evidence" +policy: + allow_implicit_invocation: false diff --git a/skills/engineering/implement-spec/SKILL.md b/skills/engineering/implement-spec/SKILL.md index 1839237..02d3d46 100644 --- a/skills/engineering/implement-spec/SKILL.md +++ b/skills/engineering/implement-spec/SKILL.md @@ -6,7 +6,7 @@ disable-model-invocation: true You have been provided a spec. This spec should have tickets associated with it, describing how to implement the spec. -The issue tracker should have been provided to you. If not, tell the user to run `/setup-matt-pocock-skills`. +The issue tracker should have been provided to you. If not, tell the user to run `/setup-skills`. The goal is the entire spec implemented on a single **integration branch**, with every ticket resolved the way the issue tracker closes work. diff --git a/skills/engineering/orchestrate-herdr/agents/openai.yaml b/skills/engineering/orchestrate-herdr/agents/openai.yaml new file mode 100644 index 0000000..c2ecac5 --- /dev/null +++ b/skills/engineering/orchestrate-herdr/agents/openai.yaml @@ -0,0 +1,5 @@ +interface: + display_name: "Orchestrate plans to merged PRs with Herdr" + short_description: "Drive planned work from context through tickets to a merged PR" +policy: + allow_implicit_invocation: false diff --git a/skills/engineering/recipe-diagrams/agents/openai.yaml b/skills/engineering/recipe-diagrams/agents/openai.yaml new file mode 100644 index 0000000..ac83ff0 --- /dev/null +++ b/skills/engineering/recipe-diagrams/agents/openai.yaml @@ -0,0 +1,5 @@ +interface: + display_name: "Recipe Diagrams" + short_description: "Turn recipes into process-flow diagrams" +policy: + allow_implicit_invocation: false diff --git a/skills/engineering/security-audit/agents/openai.yaml b/skills/engineering/security-audit/agents/openai.yaml new file mode 100644 index 0000000..54e53c9 --- /dev/null +++ b/skills/engineering/security-audit/agents/openai.yaml @@ -0,0 +1,5 @@ +interface: + display_name: "Security Audit Skill" + short_description: "Audit diffs for security and correctness risks" +policy: + allow_implicit_invocation: false diff --git a/skills/engineering/worktrees/agents/openai.yaml b/skills/engineering/worktrees/agents/openai.yaml new file mode 100644 index 0000000..dcbfd13 --- /dev/null +++ b/skills/engineering/worktrees/agents/openai.yaml @@ -0,0 +1,5 @@ +interface: + display_name: "Git Worktrees" + short_description: "Manage worktrees under a canonical repository root" +policy: + allow_implicit_invocation: false diff --git a/skills/engineering/write-discoverable-code/agents/openai.yaml b/skills/engineering/write-discoverable-code/agents/openai.yaml new file mode 100644 index 0000000..a11fcbe --- /dev/null +++ b/skills/engineering/write-discoverable-code/agents/openai.yaml @@ -0,0 +1,5 @@ +interface: + display_name: "Write Discoverable Code" + short_description: "Write searchable identifiers, comments, and file names" +policy: + allow_implicit_invocation: false diff --git a/skills/misc/bro/agents/openai.yaml b/skills/misc/bro/agents/openai.yaml new file mode 100644 index 0000000..535fc80 --- /dev/null +++ b/skills/misc/bro/agents/openai.yaml @@ -0,0 +1,5 @@ +interface: + display_name: "Bro" + short_description: "Restate messages in plain language" +policy: + allow_implicit_invocation: false diff --git a/skills/misc/show-me/agents/openai.yaml b/skills/misc/show-me/agents/openai.yaml new file mode 100644 index 0000000..139321e --- /dev/null +++ b/skills/misc/show-me/agents/openai.yaml @@ -0,0 +1,5 @@ +interface: + display_name: "Show Me" + short_description: "Explain topics with diagrams and concise artifacts" +policy: + allow_implicit_invocation: false diff --git a/skills/misc/visual-verification/agents/openai.yaml b/skills/misc/visual-verification/agents/openai.yaml new file mode 100644 index 0000000..b8bc319 --- /dev/null +++ b/skills/misc/visual-verification/agents/openai.yaml @@ -0,0 +1,5 @@ +interface: + display_name: "Visual Verification" + short_description: "Verify desktop UI changes with screenshots and recordings" +policy: + allow_implicit_invocation: false diff --git a/skills/personal/arch-maintenance/agents/openai.yaml b/skills/personal/arch-maintenance/agents/openai.yaml new file mode 100644 index 0000000..d759baa --- /dev/null +++ b/skills/personal/arch-maintenance/agents/openai.yaml @@ -0,0 +1,5 @@ +interface: + display_name: "Arch Maintenance" + short_description: "Keep Arch and CachyOS systems updated and healthy" +policy: + allow_implicit_invocation: false diff --git a/skills/personal/arch-troubleshooting/agents/openai.yaml b/skills/personal/arch-troubleshooting/agents/openai.yaml new file mode 100644 index 0000000..1d77eb1 --- /dev/null +++ b/skills/personal/arch-troubleshooting/agents/openai.yaml @@ -0,0 +1,5 @@ +interface: + display_name: "Arch Troubleshooting" + short_description: "Diagnose and repair Arch and CachyOS problems" +policy: + allow_implicit_invocation: false diff --git a/skills/pstack/bugfix-regression-test/agents/openai.yaml b/skills/pstack/bugfix-regression-test/agents/openai.yaml new file mode 100644 index 0000000..9e6b336 --- /dev/null +++ b/skills/pstack/bugfix-regression-test/agents/openai.yaml @@ -0,0 +1,5 @@ +interface: + display_name: "Bug-Fix Regression Test" + short_description: "Fix bugs test-first with focused regression tests" +policy: + allow_implicit_invocation: false diff --git a/skills/pstack/fix-merge-conflicts/agents/openai.yaml b/skills/pstack/fix-merge-conflicts/agents/openai.yaml new file mode 100644 index 0000000..1fa8615 --- /dev/null +++ b/skills/pstack/fix-merge-conflicts/agents/openai.yaml @@ -0,0 +1,5 @@ +interface: + display_name: "Fix Merge Conflicts" + short_description: "Resolve merges and validate the resulting code" +policy: + allow_implicit_invocation: false diff --git a/skills/pstack/how/agents/openai.yaml b/skills/pstack/how/agents/openai.yaml new file mode 100644 index 0000000..8725c6c --- /dev/null +++ b/skills/pstack/how/agents/openai.yaml @@ -0,0 +1,5 @@ +interface: + display_name: "How" + short_description: "Explain code behavior, flow, and architectural ownership" +policy: + allow_implicit_invocation: false diff --git a/skills/pstack/interrogate/agents/openai.yaml b/skills/pstack/interrogate/agents/openai.yaml new file mode 100644 index 0000000..bacee64 --- /dev/null +++ b/skills/pstack/interrogate/agents/openai.yaml @@ -0,0 +1,5 @@ +interface: + display_name: "Interrogate" + short_description: "Challenge code and plans with independent reviews" +policy: + allow_implicit_invocation: false diff --git a/skills/pstack/reflect/agents/openai.yaml b/skills/pstack/reflect/agents/openai.yaml new file mode 100644 index 0000000..e9e904e --- /dev/null +++ b/skills/pstack/reflect/agents/openai.yaml @@ -0,0 +1,5 @@ +interface: + display_name: "Reflect" + short_description: "Turn durable learnings into targeted skill improvements" +policy: + allow_implicit_invocation: false diff --git a/skills/pstack/unslop/agents/openai.yaml b/skills/pstack/unslop/agents/openai.yaml new file mode 100644 index 0000000..1501188 --- /dev/null +++ b/skills/pstack/unslop/agents/openai.yaml @@ -0,0 +1,5 @@ +interface: + display_name: "Unslop" + short_description: "Edit prose to remove AI patterns while preserving meaning" +policy: + allow_implicit_invocation: false diff --git a/skills/pstack/why/agents/openai.yaml b/skills/pstack/why/agents/openai.yaml new file mode 100644 index 0000000..31f2235 --- /dev/null +++ b/skills/pstack/why/agents/openai.yaml @@ -0,0 +1,5 @@ +interface: + display_name: "Why" + short_description: "Investigate code rationale using historical evidence" +policy: + allow_implicit_invocation: false diff --git a/skills/skill-authoring/effective-agent-skills/agents/openai.yaml b/skills/skill-authoring/effective-agent-skills/agents/openai.yaml new file mode 100644 index 0000000..be43c7a --- /dev/null +++ b/skills/skill-authoring/effective-agent-skills/agents/openai.yaml @@ -0,0 +1,5 @@ +interface: + display_name: "Agent Skills: A Complete Guide" + short_description: "Write and improve effective agent skills" +policy: + allow_implicit_invocation: false diff --git a/skills/thinking-and-docs/brain-to-docs/agents/openai.yaml b/skills/thinking-and-docs/brain-to-docs/agents/openai.yaml new file mode 100644 index 0000000..8c0abdc --- /dev/null +++ b/skills/thinking-and-docs/brain-to-docs/agents/openai.yaml @@ -0,0 +1,5 @@ +interface: + display_name: "Brain to Docs" + short_description: "Extract project vision and decisions into README and ADRs" +policy: + allow_implicit_invocation: false diff --git a/skills/thinking-and-docs/next-decision/agents/openai.yaml b/skills/thinking-and-docs/next-decision/agents/openai.yaml new file mode 100644 index 0000000..b5a7222 --- /dev/null +++ b/skills/thinking-and-docs/next-decision/agents/openai.yaml @@ -0,0 +1,5 @@ +interface: + display_name: "Next Decision" + short_description: "Drill the next open decision with choices and a recommendation" +policy: + allow_implicit_invocation: false diff --git a/skills/thinking-and-docs/prompt-me/agents/openai.yaml b/skills/thinking-and-docs/prompt-me/agents/openai.yaml new file mode 100644 index 0000000..ce7c538 --- /dev/null +++ b/skills/thinking-and-docs/prompt-me/agents/openai.yaml @@ -0,0 +1,5 @@ +interface: + display_name: "Prompt Me" + short_description: "Ask pointed questions to surface project priorities" +policy: + allow_implicit_invocation: false diff --git a/skills/thinking-and-docs/save-idea/agents/openai.yaml b/skills/thinking-and-docs/save-idea/agents/openai.yaml new file mode 100644 index 0000000..146519f --- /dev/null +++ b/skills/thinking-and-docs/save-idea/agents/openai.yaml @@ -0,0 +1,5 @@ +interface: + display_name: "Save Idea" + short_description: "Capture video and podcast ideas in the content backlog" +policy: + allow_implicit_invocation: false