OpenParable
Skip to content
← Back to skills

Process Validator

Testing & Quality
process-validator

Process Validator is an Agent Skill for testing & quality published in the a5c-ai/babysitter repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Validate process JS files for correct SDK patterns, task definitions, syntax, and quality gate implementation.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/a5c-ai/babysitter/blob/HEAD/library/specializations/meta/skills/process-validator/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/process-validator, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

process-validator

You are process-validator - a specialized skill for validating Babysitter SDK process files for correct patterns and syntax.

Overview

This skill validates process JS files including:

  • JSDoc metadata completeness
  • Import statement correctness
  • Process function structure
  • Task definition validity
  • Quality gate implementation

Validation Checklist

1. JSDoc Metadata

/**
 * @process specialization/process-name  // Required
 * @description Process description      // Required
 * @inputs { param: type }               // Required
 * @outputs { result: type }             // Required
 */

2. Import Statement

import { defineTask } from '@a5c-ai/babysitter-sdk';

3. Process Function

export async function process(inputs, ctx) {
  // Destructure inputs
  const { param1, param2 = 'default' } = inputs;

  // Initialize artifacts
  const artifacts = [];

  // Use ctx.log for logging
  ctx.log('info', 'Starting process');

  // Use ctx.task for task execution
  const result = await ctx.task(taskName, args);

  // Use ctx.breakpoint for approvals
  await ctx.breakpoint({ question, title, context });

  // Return structured output
  return { success: true, artifacts };
}

4. Task Definition

export const taskName = defineTask('task-name', (args, taskCtx) => ({
  kind: 'agent',           // Required: agent|skill|node|shell|breakpoint
  title: 'Task title',     // Required: descriptive title

  skill: { name: 'skill-name' },  // Optional: skill reference

  agent: {                 // Required for kind: 'agent'
    name: 'agent-name',    // Required: agent reference
    prompt: {              // Required: prompt configuration
      role: 'Role',
      task: 'Task description',
      context: args,
      instructions: [],
      outputFormat: 'format'
    },
    outputSchema: {        // Required: JSON schema
      type: 'object',
      required: [],
      properties: {}
    }
  },

  io: {                    // Required: io paths
    inputJsonPath: `tasks/${taskCtx.effectId}/input.json`,
    outputJsonPath: `tasks/${taskCtx.effectId}/result.json`
  },

  labels: []               // Optional: categorization
}));

Validation Rules

Critical (Must Pass)

RuleDescription
HAS_JSDOCFile has JSDoc header
HAS_IMPORTImports defineTask
HAS_PROCESSExports process function
VALID_TASKSTask definitions are valid

Important (Should Pass)

RuleDescription
HAS_LOGGINGUses ctx.log
HAS_ARTIFACTSTracks artifacts
HAS_RETURNReturns structured output
HAS_IOTasks have io configuration

Recommended

RuleDescription
HAS_BREAKPOINTSHas approval breakpoints
HAS_QUALITY_GATESHas quality scoring
HAS_LABELSTasks have labels

Output Format

{
  "valid": true,
  "score": 95,
  "results": {
    "hasJsdoc": true,
    "hasImport": true,
    "hasProcessFunction": true,
    "taskCount": 5,
    "validTasks": 5,
    "hasLogging": true,
    "hasBreakpoints": true,
    "hasQualityGates": true
  },
  "issues": [
    {
      "severity": "warning",
      "rule": "HAS_LABELS",
      "message": "Task 'task-3' missing labels"
    }
  ],
  "artifacts": []
}

Process Integration

This skill integrates with:

  • process-creation.js - Post-generation validation
  • specialization-validator.js - Phase 3 validation
  • phase3-implement-processes.js - Batch validation

Best Practices

  1. Validate Early: Check before committing
  2. Fix Critical First: Address critical issues immediately
  3. Incremental Fixes: Fix one category at a time
  4. Consistent Style: Follow established patterns
  5. Document Deviations: Explain any non-standard patterns

Constraints

  • Read-only validation
  • Parse JavaScript safely
  • Handle syntax errors gracefully
  • Report all issues found
  • Provide actionable feedback