rafaie/project-intake
skills/project-intake/SKILL.md
Bootstrap a new project repo, then turn a rough project idea into a concise Project Brief and starting spec docs.
$ install --global
skillsauthnpx skillsauth add rafaie/codex_home project-intakeInstall 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: May 5, 2026, 6:24 AM351.1s1 file scanned
SKILL.md
- name:
- project-intake
- description:
- Bootstrap a new project repo, then turn a rough project idea into a concise Project Brief and starting spec docs.
- Confirm you are in the target project repo, not the global Codex home directory.
- If the current repo is
/Users/mostafa/.codexor another Codex home, stop and ask for the target project path. - If the repo already has
AGENTS.md, follow it first.
- If the current repo is
- Bootstrap missing SDLC files from
/Users/mostafa/.codex/templates/.- Create missing directories:
spec/,spec/templates/,spec/decisions/,spec/features/,scripts/. - Create
AGENTS.mdfromtemplates/AGENTS.mdonly if missing. - Create
codex.tomlfromtemplates/codex.tomlonly if missing. - Copy starter templates into
spec/templates/only if missing:adr.mdarchitecture.mdbacklog.mdfeature.mdimplementation.mdtest-plan.mdtest-results.mdstatus.mdevidence.mddocstrings.mdspec_index.md
- Create smoke starters only if missing:
spec/smoke.mdfromtemplates/smoke.mdspec/smoke_registry.yamlfromtemplates/smoke_registry.yamlscripts/smoke.pyfromtemplates/smoke.py
- Create
spec/docstrings.mdfromtemplates/docstrings.mdonly if missing. - Do not overwrite existing repo-local files unless the user explicitly asks.
- Create missing directories:
- Read the user’s project idea (or
spec/idea.mdif it exists), plus the newly bootstrappedAGENTS.mdandcodex.toml. - Ask up to 5 targeted questions only if essential info is missing (goal, users, constraints, success metrics).
- Create/update:
spec/brief.md(1–2 pages) with: Goal, Users, Scope/Non-scope, Constraints, Risks, Milestones.spec/index.md(navigation hub) with links to brief, architecture, ADRs, and backlog.- Prefer
spec/templates/spec_index.mdfor a newspec/index.md.
- Initialize the project workflow state:
- Ensure
spec/changelog.mdexists with an initial entry. - Ensure
spec/decisions/exists; do not create an ADR unless a real decision is present. - Leave
spec/backlog.mdforbacklog-builderunless the user explicitly asks to create it now.
- Ensure
- End with:
- Files created
- Files preserved because they already existed
- Any commands the user should customize in
codex.toml - Proposed “first 3 work items” list (thin vertical slices)
- Exact next command:
Run $backlog-builder
Related Skills
rafaie/write-tests
testing
VerifiedTrustedCommunity
Add or improve tests based on a work item folder's acceptance criteria and test plan.
1SKILL.mdUpdated May 5, 2026
rafaie/test-runner
testing
VerifiedTrustedCommunity
Run quick/full checks consistently, include smoke, and summarize failures into actionable buckets.
1SKILL.mdUpdated May 5, 2026
rafaie/test-plan
testing
VerifiedTrustedCommunity
Create a work item test plan from acceptance criteria and add it to the work item docs.
1SKILL.mdUpdated May 5, 2026
rafaie/spec-linter
development
VerifiedTrustedCommunity
Review a work item documentation folder for clarity, testability, and completeness before implementation.
1SKILL.mdUpdated May 5, 2026