cluesmith/codev
codev-skeleton/.claude/skills/codev/SKILL.md
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.
$ install --global
skillsauthnpx skillsauth add cluesmith/codev codevInstall 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 4, 2026, 3:06 PM4.8s1 file scanned
SKILL.md
- name:
- codev
- description:
- 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.
codev - Project Management CLI
Commands
codev init [project-name] Create a new codev project directory
codev adopt Add codev to the current directory
codev update Update protocols, roles, skills from package
codev doctor Check system dependencies
codev init
Creates a new directory with the full codev structure: specs/, plans/, reviews/, protocols, CLAUDE.md, AGENTS.md, .claude/skills/, .codev/config.json, .gitignore.
codev init my-app # Interactive setup
codev init my-app -y # Non-interactive with defaults
codev adopt
Adds codev to the current directory (existing project). Run from the project root. If CLAUDE.md or AGENTS.md already exists, creates .codev-new versions and spawns Claude to merge.
codev adopt # Interactive
codev adopt -y # Skip conflict prompts
codev update
Updates framework files (protocols, roles, skills) from the installed @cluesmith/codev package. Never touches user data (specs, plans, reviews). Creates .codev-new versions for customized files.
codev update # Interactive update
codev update --dry-run # Preview changes
codev update --force # Overwrite all framework files
codev update --agent # Agent mode: JSON stdout, no interactive merge
codev doctor
Checks all required dependencies: Node.js (>=18), git (>=2.5), gh (authenticated), and at least one AI CLI (Claude, Gemini, or Codex).
codev doctor
Common mistakes
- There is NO
codev towercommand — useafx tower start/stop codev initcreates a new directory — usecodev adoptfor existing projects- Always run
codev adoptandcodev updatefrom the project root codev updateonly updates framework files — it never touches specs/plans/reviews
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/afx
tools
VerifiedTrustedCommunity
Agent Farm CLI — the tool for spawning builders, managing Tower, workspaces, and cron tasks. ALWAYS consult this skill BEFORE running any `afx` command to get the exact syntax. This prevents wasting time guessing flags that don't exist. Use this whenever you need to spawn a builder, check status, send messages, clean up worktrees, manage Tower, or run cron tasks. If you're about to type `afx` followed by anything, check here first.
254SKILL.mdUpdated Apr 4, 2026