cluesmith/.claude/skills/forge
.claude/skills/forge/SKILL.md
# Forge Concept Commands Forge concept commands decouple codev from direct `gh` CLI calls. Each GitHub operation is routed through a configurable external command. ## Concepts | Concept | Env Vars | Description | |---------|----------|-------------| | `issue-view` | `CODEV_ISSUE_ID` | Fetch issue details (JSON) | | `pr-list` | — | List open PRs (JSON array) | | `issue-list` | — | List issues (JSON array) | | `issue-comment` | `CODEV_ISSUE_ID`, `CODEV_COMMENT_BODY` | Post a comment on an issue
$ install --global
skillsauthnpx skillsauth add cluesmith/codev .claude/skills/forgeInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 24, 2026, 7:48 AM4.0s1 file scanned
SKILL.md
Forge Concept Commands
Forge concept commands decouple codev from direct gh CLI calls. Each GitHub operation is routed through a configurable external command.
Concepts
| Concept | Env Vars | Description |
|---------|----------|-------------|
| issue-view | CODEV_ISSUE_ID | Fetch issue details (JSON) |
| pr-list | — | List open PRs (JSON array) |
| issue-list | — | List issues (JSON array) |
| issue-comment | CODEV_ISSUE_ID, CODEV_COMMENT_BODY | Post a comment on an issue |
| pr-exists | CODEV_BRANCH_NAME | Check if a PR exists for a branch |
| recently-closed | CODEV_SINCE_DATE (optional) | List recently closed issues |
| recently-merged | CODEV_SINCE_DATE (optional) | List recently merged PRs |
| user-identity | — | Get current user's handle (plain text) |
| team-activity | CODEV_GRAPHQL_QUERY | Run a batched GraphQL query |
| on-it-timestamps | CODEV_ISSUE_NUMBERS, CODEV_GRAPHQL_QUERY, CODEV_REPO_OWNER, CODEV_REPO_NAME | Get "on it" comment timestamps |
| pr-merge | CODEV_PR_NUMBER | Merge a PR |
| pr-search | CODEV_SEARCH_QUERY | Search PRs (JSON array) |
| pr-view | CODEV_PR_NUMBER, CODEV_INCLUDE_COMMENTS (optional) | View PR details (JSON or text) |
| pr-diff | CODEV_PR_NUMBER, CODEV_DIFF_NAME_ONLY (optional) | Get PR diff |
| auth-status | — | Check forge authentication status |
Configuration
In .codev/config.json:
{
"forge": {
"provider": "gitlab",
"issue-comment": "my-custom-script $CODEV_ISSUE_ID"
}
}
Resolution order
- Manual concept override in
forgesection - Provider preset (if
provideris set) - Default (GitHub via
ghCLI)
Providers
Built-in presets: github (default), gitlab (via glab), gitea (via tea).
Note: Non-GitHub presets are best-effort. Output schemas may differ from GitHub's JSON contracts. Non-conforming JSON returns null — consumers handle this gracefully. Override individual concepts if a preset doesn't match your CLI version.
Disabling concepts
Set a concept to null to disable it:
{
"forge": {
"team-activity": null
}
}
Validation
Run codev doctor to see forge concept status, provider, and validation results.
Code
- Dispatcher:
packages/codev/src/lib/forge.ts - Contracts:
packages/codev/src/lib/forge-contracts.ts - Spec:
codev/specs/589-non-github-repository-support.md
Related Skills
cluesmith/porch
tools
VerifiedTrustedCommunity
Protocol orchestrator CLI — drives SPIR, ASPIR, AIR, TICK, and BUGFIX protocols via a state machine. ALWAYS check this skill before running any `porch` command. Use when you need to check project status, approve gates, signal phase completion, or manage protocol state. Also use when a builder asks about gate approvals or phase transitions.
254SKILL.mdUpdated Apr 4, 2026
cluesmith/generate-image
development
VerifiedTrustedCommunity
AI image generation via Gemini. Use when the user wants to generate, create, or make an image, or when you need to create visual assets like logos, diagrams, or illustrations. Requires GEMINI_API_KEY or GOOGLE_API_KEY.
254SKILL.mdUpdated Apr 4, 2026
cluesmith/consult
tools
VerifiedTrustedCommunity
AI consultation CLI — query Gemini, Codex, or Claude for reviews and analysis. ALWAYS check this skill before running any `consult` command. Use when reviewing specs, plans, implementations, or PRs with external models, running parallel 3-way reviews (cmap), or checking consultation stats. The `-m` model flag is always required except for `consult stats`.
254SKILL.mdUpdated Apr 4, 2026
cluesmith/codev
tools
VerifiedTrustedCommunity
Codev project management CLI — init, adopt, update, and doctor commands. Check this skill before running any `codev` command (except `consult`, `porch`, or `afx` which have their own skills). Use when setting up new projects, adding codev to existing repos, updating framework files, or diagnosing missing dependencies.
254SKILL.mdUpdated Apr 4, 2026