project-onboard

Analyze repository files to infer project conventions and generate CLAUDE.md content.

5|1|Updated Apr 10, 2026
One-click install
npx skills add https://github.com/garethrhughes/fragile --skill project-onboard-garethrhughes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-onboard
Source: https://github.com/garethrhughes/fragile/tree/main/.opencode/skills/project-onboard
Command: npx skills add https://github.com/garethrhughes/fragile --skill project-onboard-garethrhughes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you adopt an existing codebase by reading the repository first and turning what it finds into structured onboarding context, so you do not have to guess at project conventions, stack choices, or hidden decisions.

Core Features & Use Cases

  • Repository Investigation: Scans the codebase to infer project identity, stack, infrastructure, structure, and conventions from actual files.
  • Evidence-Backed Metadata: Produces a filled-in CLAUDE.md and a reusable Project Context block with gaps clearly marked as [TBD].
  • Onboarding for Existing Projects: Useful when joining a mature repository, replacing an older AI setup, or documenting a codebase before making changes.

Quick Start

Use the project-onboard skill to inspect this repository, infer the project settings, and draft the CLAUDE.md and Project Context block.

Frequently Asked Questions about project-onboard

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate onboarding context for an existing codebase?

Repository structure analysis infers your project's stack and infrastructure by scanning actual files. This skill examines your codebase to document conventions and hidden decisions, producing a structured onboarding context block that eliminates guesswork during codebase adoption.

What is the best way to document project conventions before making code changes?

The best way to document project conventions is to scan the repository for evidence of stack choices and infrastructure. This skill reads your files to extract domain rules and settings, drafting a filled-in CLAUDE.md that marks any ambiguous gaps clearly as [TBD].

How do I create a CLAUDE.md file from an existing repository?

You can create a CLAUDE.md file from an existing repository by analyzing its files to detect the tech stack and infrastructure. This skill investigates your codebase to draft the CLAUDE.md content and a Project Context block, using repository files as the source of truth.

Can I use repository analysis to detect the tech stack and infrastructure of a mature project?

Yes, you can use repository analysis to detect the tech stack and infrastructure of a mature project. This skill performs infrastructure review and stack detection by scanning actual files, ensuring the inferred metadata accurately reflects the current state of your codebase.

What happens to undocumented or missing settings during codebase onboarding?

During codebase onboarding, undocumented or missing settings are explicitly flagged as gaps. This skill produces evidence-backed metadata and marks any inferred settings that cannot be verified against repository files as [TBD] in the generated Project Context block.