project-skill-audit

name	project-skill-audit
description	Analyze a project's past Codex sessions, memory files, and existing local skills to recommend the highest-value skills to create or update. Use when a user asks what skills a project needs, wants skill ideas grounded in real project history, wants an audit of current project-local skills, or wants recommendations for updating stale or incomplete skills instead of creating duplicates.

Project Skill Audit

Overview

Audit recurring project workflows before recommending skills. Prefer evidence from memory, rollout summaries, existing repo-local skills, and current repo conventions over generic brainstorming. Recommend updates before new skills when an existing local skill is already close to the needed behavior.

Audit Workflow

1. Map the current project surface first.

   • Identify the repo root.
   • Read the most relevant project guidance first, usually AGENTS.md, README.md, and the current roadmap, execution board, or workflow docs.
   • Capture the repo's validation rules, ownership boundaries, and any required run or test commands.

2. Build the memory and session paths before searching.

   • Resolve the memory base as $CODEX_HOME when set, otherwise default to ~/.codex.
   • Use:
     • memories/MEMORY.md
     • memories/rollout_summaries/
     • sessions/

3. Read past project sessions in the right order.

   • If the current prompt already includes a memory summary, start there.
   • Search MEMORY.md for:
     • repo name
     • repo basename
     • current cwd
     • important module or file names