Which documentation files does the skill look for?

It prioritizes agents.md, repo_workflow.md, onboarding.md, REPO_MAP.md, and PRDs to establish a comprehensive project overview.

What is deterministic onboarding?

Deterministic onboarding is a structured process that ensures Claude reads specific high-priority files in a predefined order rather than scanning the entire repository at random.

How does bounded discovery improve performance?

By limiting discovery to 10 files per slice, it prevents context window saturation and ensures the agent focuses only on the most relevant code for the immediate task.

Where are the onboarding logs stored?

The skill automatically appends an entry to agent_logs/current.md, documenting the agent's intent and planned next steps for future reference.

Deterministic Repo Onboarding

Name: Deterministic Repo Onboarding
Author: MykolaPinchuk

byMykolaPinchuk

0•

Productivity & Workflow

Streamlines AI agent integration into new codebases through structured document reading and bounded file discovery.

The Onboard skill provides a deterministic framework for Claude to understand a repository without performing exhaustive or noisy file scans. By following a strict sequence of reading core documentation—such as repository maps, PRDs, and workflow guides—it builds a high-fidelity mental model of the project quickly. The skill concludes with a standardized output contract that summarizes the current state, identifies risks, and proposes clear next steps, while logging all actions to maintain a transparent audit trail of the agent's intent.

Key Features

01Bounded discovery limited to 10 high-relevance files per slice

02Standardized output contract with state summaries and risk assessment

03Automated logging of intent and next steps to agent_logs

040 GitHub stars

05Prioritized reading of critical index and documentation files

06Agent-to-agent (A2A) context handoff optimization

Use Cases

01Initializing a new development session in an unfamiliar repository

02Handing off project context between different AI agents or sessions

03Rapidly assessing project status and implementation risks for a new feature

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mykolapinchuk/qamas onboard

For use in Claude.ai and ChatGPT

Download Skill