Process validator

Skill a5c-ai/babysitter/library/specializations/meta/skills/process-validator

Babysitter enforces obedience on agentic workforces and enables them to manage extremely complex tasks and workflows through deterministic, hallucination-free self-orchestration

Install

npx -y skills add a5c-ai/babysitter --skill process-validator

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

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

SKILL.md

4.5 KB, as published. Nobody here has run it

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)

Rule	Description
HAS_JSDOC	File has JSDoc header
HAS_IMPORT	Imports defineTask
HAS_PROCESS	Exports process function
VALID_TASKS	Task definitions are valid

Important (Should Pass)

Rule	Description
HAS_LOGGING	Uses ctx.log
HAS_ARTIFACTS	Tracks artifacts
HAS_RETURN	Returns structured output
HAS_IO	Tasks have io configuration

Rule	Description
HAS_BREAKPOINTS	Has approval breakpoints
HAS_QUALITY_GATES	Has quality scoring
HAS_LABELS	Tasks 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

Validate Early: Check before committing
Fix Critical First: Address critical issues immediately
Incremental Fixes: Fix one category at a time
Consistent Style: Follow established patterns
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