intent-layer-onboarding

Guide developers through codebase onboarding using Intent Layer and AGENTS.md.

8|1|Updated Jan 21, 2026
One-click install
npx skills add https://github.com/orban/intent-layer --skill intent-layer-onboarding
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: intent-layer-onboarding
Source: https://github.com/orban/intent-layer/tree/main/skills/intent-layer-onboarding
Command: npx skills add https://github.com/orban/intent-layer --skill intent-layer-onboarding

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams quickly orient new developers in an unfamiliar codebase by leveraging the Intent Layer to surface entry points, ownership, and governance documents, reducing ramp-up time.

Core Features & Use Cases

  • Guided Orientation: Step-by-step workflow to understand root concepts, subsystem boundaries, and global contracts.
  • Role-Based Onboarding: Tailored paths for new engineers (frontend, backend, DevOps) to identify where to start.
  • Operational Playbooks: Quick-start scripts and checks to verify project state and navigate the codebase.

Quick Start

Use the Intent Layer Onboarding skill to orient a newcomer in a codebase by following the scripted 15-minute workflow:

  • Check state with ${CLAUDE_PLUGIN_ROOT}/scripts/detect_state.sh /path/to/project
  • Generate an orientation overview with scripts/generate_orientation.sh /path/to/project
  • View the project hierarchy with ${CLAUDE_PLUGIN_ROOT}/scripts/show_hierarchy.sh /path/to/project

Frequently Asked Questions about intent-layer-onboarding

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

FAQPage Schema
How do I onboard a new developer into a codebase with AGENTS.md?

Onboard a developer by reading root and area AGENTS.md files to surface entry points, ownership, and governance. A scripted 15-minute workflow guides new-joiners through subsystem boundaries and global contracts using quick-start verification scripts.

What is the Intent Layer for codebase orientation?

The Intent Layer is a codebase structure using AGENTS.md files to document entry points, ownership, and governance. It helps developers understand subsystem boundaries and global contracts quickly during the onboarding process.

Can I use role-based paths for frontend and backend codebase onboarding?

Yes, role-based onboarding provides tailored paths for new engineers in frontend, backend, and DevOps. Each path identifies specific entry points and starting locations relevant to that role's responsibilities within the codebase.

How do I verify project state and identify entry points during onboarding?

Verify project state by running the detect_state.sh script, generate an orientation overview with generate_orientation.sh, and view the project hierarchy using show_hierarchy.sh. These scripts check state and identify entry points automatically.

Does this onboarding workflow support cross-team task-oriented orientation?

Yes, the workflow supports cross-team onboarding and task-oriented orientation. It guides developers through the codebase using role-based paths and entry points documented in AGENTS.md files to reduce ramp-up time.

What are the limitations of codebase onboarding without AGENTS.md files?

Without AGENTS.md files at the root and area levels, the onboarding workflow cannot surface entry points, ownership, or governance documents. The scripts rely on this Intent Layer structure to generate orientation overviews and verify project state.