feat(devops): 13 CLI-backed skills for forge, workspace, and diagnostics

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 <virgil@lethean.io>
This commit is contained in:
Snider 2026-03-22 14:38:54 +00:00
parent f416948660
commit 7e30f336cc
12 changed files with 247 additions and 0 deletions

View file

@ -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: <repo> [--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 <repo> --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
```

View file

@ -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
```

View file

@ -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: <repo> --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 <repo> --number=N --body="comment text" [--org=core]
```
Example:
```bash
core-agent issue/comment go --number=16 --body="Fixed in v0.6.0"
```

View file

@ -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: <repo> --number=N [--org=core]
allowed-tools: ["Bash"]
---
# Get Forge Issue
Fetch and display a Forge issue by number.
```bash
core-agent issue/get <repo> --number=N [--org=core]
```
Example:
```bash
core-agent issue/get go --number=16
core-agent issue/get agent --number=5 --org=core
```

View file

@ -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: <repo> [--org=core]
allowed-tools: ["Bash"]
---
# List Forge Issues
List all issues for a Forge repository.
```bash
core-agent issue/list <repo> [--org=core]
```
Example:
```bash
core-agent issue/list go
core-agent issue/list agent
```

View file

@ -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: <repo> --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 <repo> --number=N [--org=core]
```
Example:
```bash
core-agent pr/get go --number=22
```

View file

@ -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: <repo> [--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 <repo> [--org=core]
```
Example:
```bash
core-agent pr/list go
core-agent pr/list agent
```

View file

@ -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: <repo> --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 <repo> --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

View file

@ -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: <repo> [--org=core]
allowed-tools: ["Bash"]
---
# Get Forge Repository Info
Fetch and display repository details from Forge.
```bash
core-agent repo/get <repo> [--org=core]
```
Example:
```bash
core-agent repo/get go
core-agent repo/get agent
```

View file

@ -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
```

View file

@ -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
```

View file

@ -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.