nacl-tl-status

Compute project progress and blockers from Neo4j Task/Wave nodes.

23|2|Updated Apr 10, 2026
One-click install
npx skills add https://github.com/ITSalt/NaCl --skill nacl-tl-status
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nacl-tl-status
Source: https://github.com/ITSalt/NaCl/tree/main/nacl-tl-status
Command: npx skills add https://github.com/ITSalt/NaCl --skill nacl-tl-status

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Graph-aware project status that derives progress, blockers, and SA coverage metrics from Neo4j Task/Wave nodes, with a fallback to local status data to ensure continuous reporting.

Core Features & Use Cases

  • Graph-driven progress: computes overall progress from Task/Wave nodes, including blockers and phase details.
  • SA coverage metrics: exposes UC detail completeness, entity attribute completeness, and handoff readiness scores in graph mode.
  • Fallback data: reads from .tl/status.json when Neo4j is unavailable to ensure reporting continuity.
  • Read-only operation: does not modify graph data or local files; provides insights only.
  • Invocation: can be triggered via /nacl-tl-status with optional filters to tailor the report.

Quick Start

Run /nacl-tl-status to generate a full project health report.

Frequently Asked Questions about nacl-tl-status

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

FAQPage Schema
How do I track project progress and blockers using Neo4j Task and Wave nodes?

To track project progress and blockers using Neo4j Task and Wave nodes, you can generate a graph-powered status report. This approach computes overall progress, phase details, and identifies blocked tasks by running named queries like tl_progress_stats and tl_blocked_tasks against the graph.

Can I generate project status reports when my Neo4j database is unavailable?

Yes, you can generate project status reports when Neo4j is unavailable by falling back to local status data. The system reads from a .tl/status.json file to ensure continuous reporting of progress and blockers without graph connectivity.

What are SA coverage metrics and how are they calculated from a project graph?

SA coverage metrics are calculated from a project graph to measure UC detail completeness, entity attribute completeness, and handoff readiness scores. These metrics are derived in graph mode to provide insights into solution architect coverage for TL-driven projects.

Does the graph project status report modify Neo4j data or local files?

No, the graph project status report does not modify Neo4j data or local files. It operates as a read-only tool that queries named views like tl_progress_by_wave and tl_phase_progress to provide insights without altering the underlying data.

How do I generate a project health report with optional filters for blockers and waves?

To generate a project health report with optional filters for blockers and waves, trigger the status command and apply the desired parameters. This action queries the graph for progress stats, phase details, and blocked tasks, tailoring the read-only output to your needs.