From 7e30f336cc619c6e5564262b593fc528a9a293b7 Mon Sep 17 00:00:00 2001 From: Snider Date: Sun, 22 Mar 2026 14:38:54 +0000 Subject: [PATCH] feat(devops): 13 CLI-backed skills for forge, workspace, and diagnostics MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Thin skill wrappers over core-agent CLI commands: - workspace-list, workspace-clean - issue-get, issue-list, issue-comment - pr-get, pr-list, pr-merge - repo-get, repo-list - build-prompt, health-check Each skill calls core-agent directly — no raw API calls, no remembering flags. Edge cases fixed in the skill. Co-Authored-By: Virgil --- claude/devops/skills/build-prompt/SKILL.md | 20 ++++++++++++++ claude/devops/skills/health-check/SKILL.md | 23 ++++++++++++++++ claude/devops/skills/issue-comment/SKILL.md | 19 ++++++++++++++ claude/devops/skills/issue-get/SKILL.md | 20 ++++++++++++++ claude/devops/skills/issue-list/SKILL.md | 20 ++++++++++++++ claude/devops/skills/pr-get/SKILL.md | 19 ++++++++++++++ claude/devops/skills/pr-list/SKILL.md | 20 ++++++++++++++ claude/devops/skills/pr-merge/SKILL.md | 26 +++++++++++++++++++ claude/devops/skills/repo-get/SKILL.md | 20 ++++++++++++++ claude/devops/skills/repo-list/SKILL.md | 20 ++++++++++++++ claude/devops/skills/workspace-clean/SKILL.md | 24 +++++++++++++++++ claude/devops/skills/workspace-list/SKILL.md | 16 ++++++++++++ 12 files changed, 247 insertions(+) create mode 100644 claude/devops/skills/build-prompt/SKILL.md create mode 100644 claude/devops/skills/health-check/SKILL.md create mode 100644 claude/devops/skills/issue-comment/SKILL.md create mode 100644 claude/devops/skills/issue-get/SKILL.md create mode 100644 claude/devops/skills/issue-list/SKILL.md create mode 100644 claude/devops/skills/pr-get/SKILL.md create mode 100644 claude/devops/skills/pr-list/SKILL.md create mode 100644 claude/devops/skills/pr-merge/SKILL.md create mode 100644 claude/devops/skills/repo-get/SKILL.md create mode 100644 claude/devops/skills/repo-list/SKILL.md create mode 100644 claude/devops/skills/workspace-clean/SKILL.md create mode 100644 claude/devops/skills/workspace-list/SKILL.md diff --git a/claude/devops/skills/build-prompt/SKILL.md b/claude/devops/skills/build-prompt/SKILL.md new file mode 100644 index 0000000..0fead0d --- /dev/null +++ b/claude/devops/skills/build-prompt/SKILL.md @@ -0,0 +1,20 @@ +--- +name: build-prompt +description: This skill should be used when the user asks to "build prompt", "show prompt", "preview agent prompt", "what would codex see", or needs to preview the prompt that would be sent to a dispatched agent without actually cloning or dispatching. +argument-hint: [--task="..."] [--persona=...] [--org=core] +allowed-tools: ["Bash"] +--- + +# Build Agent Prompt + +Preview the full prompt that would be sent to a dispatched agent. Shows task, repo info, workflow, brain recall, consumers, git log, and constraints — without cloning or dispatching. + +```bash +core-agent prompt --task="description" [--persona=code/go] [--org=core] +``` + +Example: +```bash +core-agent prompt go-io --task="AX audit" +core-agent prompt agent --task="Fix monitor package" --persona=code/go +``` diff --git a/claude/devops/skills/health-check/SKILL.md b/claude/devops/skills/health-check/SKILL.md new file mode 100644 index 0000000..5ec040d --- /dev/null +++ b/claude/devops/skills/health-check/SKILL.md @@ -0,0 +1,23 @@ +--- +name: health-check +description: This skill should be used when the user asks to "check health", "is core-agent working", "check agent", "health check", "system status", or needs to verify the core-agent binary, config, and workspace are healthy. +argument-hint: (no arguments needed) +allowed-tools: ["Bash"] +--- + +# Core Agent Health Check + +Verify binary, agents.yaml, workspace directory, and environment. + +```bash +core-agent check +``` + +Also useful: +```bash +# Show all environment keys and values +core-agent env + +# Show version and build info +core-agent version +``` diff --git a/claude/devops/skills/issue-comment/SKILL.md b/claude/devops/skills/issue-comment/SKILL.md new file mode 100644 index 0000000..83ec3d4 --- /dev/null +++ b/claude/devops/skills/issue-comment/SKILL.md @@ -0,0 +1,19 @@ +--- +name: issue-comment +description: This skill should be used when the user asks to "comment on issue", "add comment", "reply to issue", or needs to post a comment on a Forge issue. +argument-hint: --number=N --body="comment text" [--org=core] +allowed-tools: ["Bash"] +--- + +# Comment on Forge Issue + +Post a comment on a Forge issue. + +```bash +core-agent issue/comment --number=N --body="comment text" [--org=core] +``` + +Example: +```bash +core-agent issue/comment go --number=16 --body="Fixed in v0.6.0" +``` diff --git a/claude/devops/skills/issue-get/SKILL.md b/claude/devops/skills/issue-get/SKILL.md new file mode 100644 index 0000000..cda481a --- /dev/null +++ b/claude/devops/skills/issue-get/SKILL.md @@ -0,0 +1,20 @@ +--- +name: issue-get +description: This skill should be used when the user asks to "get issue", "show issue", "read issue", "fetch issue", or needs to view a specific Forge issue by number. +argument-hint: --number=N [--org=core] +allowed-tools: ["Bash"] +--- + +# Get Forge Issue + +Fetch and display a Forge issue by number. + +```bash +core-agent issue/get --number=N [--org=core] +``` + +Example: +```bash +core-agent issue/get go --number=16 +core-agent issue/get agent --number=5 --org=core +``` diff --git a/claude/devops/skills/issue-list/SKILL.md b/claude/devops/skills/issue-list/SKILL.md new file mode 100644 index 0000000..19a97a0 --- /dev/null +++ b/claude/devops/skills/issue-list/SKILL.md @@ -0,0 +1,20 @@ +--- +name: issue-list +description: This skill should be used when the user asks to "list issues", "show issues", "what issues are open", or needs to see issues for a Forge repo. +argument-hint: [--org=core] +allowed-tools: ["Bash"] +--- + +# List Forge Issues + +List all issues for a Forge repository. + +```bash +core-agent issue/list [--org=core] +``` + +Example: +```bash +core-agent issue/list go +core-agent issue/list agent +``` diff --git a/claude/devops/skills/pr-get/SKILL.md b/claude/devops/skills/pr-get/SKILL.md new file mode 100644 index 0000000..426a60d --- /dev/null +++ b/claude/devops/skills/pr-get/SKILL.md @@ -0,0 +1,19 @@ +--- +name: pr-get +description: This skill should be used when the user asks to "get PR", "show PR", "read pull request", "fetch PR", or needs to view a specific Forge pull request by number. +argument-hint: --number=N [--org=core] +allowed-tools: ["Bash"] +--- + +# Get Forge Pull Request + +Fetch and display a Forge PR by number. Shows state, branch, mergeability. + +```bash +core-agent pr/get --number=N [--org=core] +``` + +Example: +```bash +core-agent pr/get go --number=22 +``` diff --git a/claude/devops/skills/pr-list/SKILL.md b/claude/devops/skills/pr-list/SKILL.md new file mode 100644 index 0000000..9271d03 --- /dev/null +++ b/claude/devops/skills/pr-list/SKILL.md @@ -0,0 +1,20 @@ +--- +name: pr-list +description: This skill should be used when the user asks to "list PRs", "show pull requests", "what PRs are open", "pending PRs", or needs to see pull requests for a Forge repo. +argument-hint: [--org=core] +allowed-tools: ["Bash"] +--- + +# List Forge Pull Requests + +List all pull requests for a Forge repository. Shows state, branches, title. + +```bash +core-agent pr/list [--org=core] +``` + +Example: +```bash +core-agent pr/list go +core-agent pr/list agent +``` diff --git a/claude/devops/skills/pr-merge/SKILL.md b/claude/devops/skills/pr-merge/SKILL.md new file mode 100644 index 0000000..119b988 --- /dev/null +++ b/claude/devops/skills/pr-merge/SKILL.md @@ -0,0 +1,26 @@ +--- +name: pr-merge +description: This skill should be used when the user asks to "merge PR", "merge pull request", "accept PR", or needs to merge a Forge PR. Supports merge, rebase, and squash methods. +argument-hint: --number=N [--method=merge|rebase|squash] [--org=core] +allowed-tools: ["Bash"] +--- + +# Merge Forge Pull Request + +Merge a PR on Forge. Default method is merge. + +```bash +core-agent pr/merge --number=N [--method=merge|rebase|squash] [--org=core] +``` + +Example: +```bash +core-agent pr/merge go --number=22 +core-agent pr/merge go-forge --number=7 --method=squash +``` + +## Important + +- Always confirm with the user before merging +- Check PR status with `pr/get` first if unsure about mergeability +- The merge happens on Forge, not locally diff --git a/claude/devops/skills/repo-get/SKILL.md b/claude/devops/skills/repo-get/SKILL.md new file mode 100644 index 0000000..7447534 --- /dev/null +++ b/claude/devops/skills/repo-get/SKILL.md @@ -0,0 +1,20 @@ +--- +name: repo-get +description: This skill should be used when the user asks to "get repo info", "show repo", "repo details", or needs to see details about a specific Forge repository including default branch, visibility, and archive status. +argument-hint: [--org=core] +allowed-tools: ["Bash"] +--- + +# Get Forge Repository Info + +Fetch and display repository details from Forge. + +```bash +core-agent repo/get [--org=core] +``` + +Example: +```bash +core-agent repo/get go +core-agent repo/get agent +``` diff --git a/claude/devops/skills/repo-list/SKILL.md b/claude/devops/skills/repo-list/SKILL.md new file mode 100644 index 0000000..e0bd0db --- /dev/null +++ b/claude/devops/skills/repo-list/SKILL.md @@ -0,0 +1,20 @@ +--- +name: repo-list +description: This skill should be used when the user asks to "list repos", "show repos", "what repos exist", "how many repos", or needs to see all repositories in a Forge organisation. +argument-hint: [--org=core] +allowed-tools: ["Bash"] +--- + +# List Forge Repositories + +List all repositories in a Forge organisation. + +```bash +core-agent repo/list [--org=core] +``` + +Example: +```bash +core-agent repo/list +core-agent repo/list --org=lthn +``` diff --git a/claude/devops/skills/workspace-clean/SKILL.md b/claude/devops/skills/workspace-clean/SKILL.md new file mode 100644 index 0000000..2b8eba5 --- /dev/null +++ b/claude/devops/skills/workspace-clean/SKILL.md @@ -0,0 +1,24 @@ +--- +name: workspace-clean +description: This skill should be used when the user asks to "clean workspaces", "clean up agents", "remove stale workspaces", "nuke completed", or needs to remove finished/failed/blocked agent workspaces. +argument-hint: [all|completed|failed|blocked] +allowed-tools: ["Bash"] +--- + +# Clean Agent Workspaces + +Remove stale agent workspaces. Never removes running workspaces. + +```bash +# Remove all non-running workspaces +core-agent workspace/clean all + +# Remove only completed/merged +core-agent workspace/clean completed + +# Remove only failed +core-agent workspace/clean failed + +# Remove only blocked +core-agent workspace/clean blocked +``` diff --git a/claude/devops/skills/workspace-list/SKILL.md b/claude/devops/skills/workspace-list/SKILL.md new file mode 100644 index 0000000..fbb3900 --- /dev/null +++ b/claude/devops/skills/workspace-list/SKILL.md @@ -0,0 +1,16 @@ +--- +name: workspace-list +description: This skill should be used when the user asks to "list workspaces", "show agents", "what's running", "workspace status", "active agents", or wants to see the current state of all agent workspaces. +argument-hint: (no arguments needed) +allowed-tools: ["Bash"] +--- + +# List Agent Workspaces + +Show all agent workspaces with their status, agent type, and repo. + +```bash +core-agent workspace/list +``` + +Output shows: status, agent, repo, workspace name. Statuses: running, completed, failed, blocked, merged, queued.