1 Commits

  • feat(skills): add codebase-onboarding skill (#553)
    * feat(skills): add codebase-onboarding skill
    
    Adds a skill that systematically analyzes an unfamiliar codebase and
    produces two artifacts: a structured onboarding guide and a starter
    CLAUDE.md tailored to the project's conventions.
    
    Four-phase workflow:
    1. Reconnaissance — parallel detection of manifests, frameworks, entry
       points, directory structure, tooling, and test setup
    2. Architecture mapping — tech stack, patterns, key directories, request
       lifecycle tracing
    3. Convention detection — naming, error handling, async patterns, git
       workflow from recent history
    4. Artifact generation — scannable onboarding guide + project-specific
       CLAUDE.md
    
    Includes Antigravity support via .agents/skills/ and openai.yaml.
    
    * fix: address review feedback on codebase-onboarding skill
    
    - Rename headings to match skill format: When to Activate → When to Use,
      Onboarding Workflow → How It Works
    - Add Examples section with 3 usage scenarios
    - Mark Phase 4 Next.js paths as example with HTML comments
    - Fix CLAUDE.md generation to read/enhance existing file first
    - Replace abbreviated .agents/ SKILL.md with full copy per repo convention
    
    * fix: add example marker to Common Tasks template section
    
    Adds <!-- Example for a Node.js project --> comment to Common Tasks,
    matching the markers already on Key Entry Points and Where to Look.
    Syncs .agents/ copy.
    
    * fix: add missing example markers and shorten default_prompt
    
    - Add example comment to Tech Stack table in Phase 4 template
    - Add example comment to Key Directories block in Phase 2
    - Shorten openai.yaml default_prompt to match repo convention (~60 chars)
    - Sync .agents/ SKILL.md copy
    
    * fix: add empty-repo fallback and remove hardcoded output path
    
    - Phase 3: add fallback for repos with no git history
    - Example 1: remove hardcoded docs/ path assumption, output to
      conversation or project root instead
    - Sync .agents/ copy
    
    * fix: remove .agents/ duplicate, keep canonical in skills/
    
    * fix: clarify Example 1 output destination
    
    * fix: add shallow-clone fallback to git conventions detection
    
    ---------
    
    Co-authored-by: vazidmansuri005 <vazidmansuri005@users.noreply.github.com>