node-review

Audit node implementations against NODE_DEVELOPMENT_BLUEPRINT and generate structured review reports.

Updated Jul 10, 2025
One-click install
npx skills add https://github.com/Narcis13/workscript --skill node-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: node-review
Source: https://github.com/Narcis13/workscript/tree/main/.claude/skills/node-review
Command: npx skills add https://github.com/Narcis13/workscript --skill node-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Node review and governance: ensures Workscript node implementations adhere to established blueprints, single-edge return patterns, and metadata consistency to reduce bugs and interoperability issues.

Core Features & Use Cases

  • Audit node implementations against NODE_DEVELOPMENT_BLUEPRINT.md and NEW_NODE patterns.
  • Validate ai_hints metadata, state interactions, and documentation quality.
  • Produce structured Node Review reports with actionable fixes for teams.

Quick Start

Provide a node implementation or code sample for review and request a full node-review report.

Frequently Asked Questions about node-review

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

FAQPage Schema
How do I audit node implementations for compliance with development blueprints?

To audit node implementations, you validate the code against the NODE_DEVELOPMENT_BLUEPRINT and new-node patterns. This ensures metadata consistency, accurate edge routing, and single-edge return patterns to reduce bugs and interoperability issues.

What is a single-edge return pattern in state management workflows?

A single-edge return pattern ensures deterministic behavior by returning exactly one edge per code path in a node implementation. This explicit routing prevents ambiguous state transitions and unexpected execution branches during workflow processing.

How do I validate ai_hints metadata and state interactions in a code review?

Validating ai_hints metadata involves applying reference documents to check structure, state interactions, and documentation quality across node implementations. The process generates a structured review report highlighting non-compliant areas and actionable fixes.

Can I review node code to ensure deterministic behavior and explicit error handling?

Yes, reviewing node code for deterministic behavior involves checking that each code path returns a single edge and handles errors explicitly. This ensures the node implementation adheres to established blueprints and operates predictably.

What's the best way to generate a structured review report for node governance?

Generating a structured review report requires providing a node implementation sample for analysis. The review audits compliance, ai_hints metadata, and state interactions, outputting actionable fixes for development teams to improve quality.