beads-orient

Run diagnostics, synthesize project status, and identify next actions at session start.

1|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/justin-delano/Claude-Config --skill beads-orient
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: beads-orient
Source: https://github.com/justin-delano/Claude-Config/tree/main/skills/conditional/beads/orient
Command: npx skills add https://github.com/justin-delano/Claude-Config --skill beads-orient

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Streamlines session initialization by running diagnostics, summarizing project health, and outlining next actions to take at the start of a beads workflow.

Core Features & Use Cases

  • Diagnostics: run quick health checks to surface issues, health gaps, and risks.
  • Status Synthesis: present a concise, human-readable view of project state and epic progress.
  • Actionable Planning: identify immediate next steps and prioritize follow-up work.

Quick Start

Run the orientation to initialize the session.

Frequently Asked Questions about beads-orient

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

FAQPage Schema
How do I initialize a project management session with diagnostics and status?

To initialize a project management session, run an orientation process that executes health diagnostics, synthesizes project status, and identifies next actions. This surfaces project health, highlights gaps, and guides immediate follow-up work.

What is the best way to surface project health gaps at the start of a workflow?

Surfacing project health gaps requires running quick diagnostics at session start to identify issues and risks. The orientation process synthesizes this into a concise view of project state and epic progress for actionable planning.

How does session triage work for identifying next actions in project management?

Session triage works by running diagnostics to assess project state, then synthesizing epic progress and health metrics. It identifies immediate next steps and prioritizes follow-up work to guide action across the workflow.

Do I need a healthy graph state to run project status diagnostics?

Yes, running project status diagnostics requires a healthy graph state and access to issue metadata. Compatibility with beads commands for health metrics and epic status is also necessary to surface gaps and guide action.

Can I use session orientation to summarize epic progress and project state?

Yes, you can use session orientation to present a concise, human-readable view of project state and epic progress. It synthesizes health metrics and issue metadata to outline actionable next steps for the session.

What are the limitations of running session initialization diagnostics for project triage?

Session initialization diagnostics for project triage are limited by the requirement of a healthy graph state and access to issue metadata. Without compatibility with beads commands for health metrics, the status synthesis cannot surface gaps effectively.