skills.rest
stencila
stencilaOFFICIAL
Explore all skills by this author →
WebsiteGitHub

workflow-review

Review Stencila workflows for correctness, quality, and workspace conventions.

900|58|Updated May 31, 2012
Search Tags:#workflow#validation#audit#review#DOT#Stencila
One-click install
npx skills add https://github.com/stencila/stencila --skill workflow-review-stencila
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: workflow-review
Source: https://github.com/stencila/stencila/tree/main/.stencila/skills/workflow-review
Command: npx skills add https://github.com/stencila/stencila --skill workflow-review-stencila

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill ensures Stencila workflows are high-quality, correct, and adhere to best practices, preventing errors and improving efficiency.

Core Features & Use Cases

  • Comprehensive Review: Analyzes frontmatter, DOT pipeline structure, agent selection, and adherence to workspace conventions.
  • Actionable Feedback: Provides specific suggestions for improvement, prioritized by impact.
  • Use Case: You've created a new workflow for generating reports, but you're unsure if it's optimized. Use this Skill to get a detailed critique and a clear list of changes to make it production-ready.

Quick Start

Use the workflow-review skill to audit the 'code-generation' workflow.

Frequently Asked Questions about workflow-review

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

FAQPage Schema
How do I audit a Stencila workflow for correctness and adherence to workspace conventions?▼

To review a Stencila workflow, analyze its frontmatter, DOT pipeline structure, agent selection, and discovery metadata. This validates correctness against workspace conventions and yields actionable suggestions to improve overall workflow quality.

What is a DOT pipeline structure and why does it matter for workflow validation?▼

A DOT pipeline structure defines the execution graph within Stencila workflows. Reviewing this DOT structure validates agent selection and task sequencing, which prevents execution errors and ensures the workflow adheres to workspace conventions.

How do I improve my Stencila workflow before making it production-ready?▼

Improve a Stencila workflow by critically reviewing its frontmatter, DOT pipeline, and metadata. This generates a prioritized list of actionable changes that optimize agent selection and align the workflow with workspace conventions for production readiness.

Can I check if my Stencila workflow has the correct discovery metadata and agent selection?▼

Yes, you can check discovery metadata and agent selection by running a comprehensive workflow review. This validates the workflow components against workspace conventions and highlights incorrect configurations with specific improvement suggestions.

What are common limitations when reviewing Stencila workflows for frontmatter and DOT structure errors?▼

Workflow reviews focus strictly on analyzing frontmatter, DOT pipeline structure, and discovery metadata. A key limitation is providing actionable suggestions rather than automatically applying fixes, requiring manual implementation of the recommended validation steps.

Related Skills

Explore More Software Engineering Skills→
stencilastencila
900

workflow-creation

Scaffold Stencila workflow directories and WORKFLOW.md files with naming conventions.

Official
Advanced
Chachamaru127Chachamaru127
3.0k

verify

Verify builds, recover from errors, and apply review fixes across CI pipelines.

Community
Intermediate
stencilastencila
900

skill-creation

Scaffold Stencila skill directories with SKILL.md and validate them.

Official
Basic
xiongxianfeixiongxianfei
3

portable-basic

Automate tool-agnostic software delivery using portable RigorLoop workflow artifacts.

Community
Basic