Create Log

Overview

Add a structured log entry to the workflow's NDJSON log file. Use this skill for progress milestones, errors, warnings, decisions, and context that should be recorded. Creates a structured log entry in the workflow's log file for tracking and debugging.

Arguments

Definitions

•<workflow-id> (required): The workflow identifier for output organization.
•<level> (required): Log level. Values: Critical, Error, Warning, Information.
•<step> (required): Step name for context (e.g., analyze, plan, review).
•<message> (required): Log message.

Values

$ARGUMENTS

Core Principles

•Use appropriate log levels for severity
•Include step context for traceability
•Messages should be concise but informative
•Logs are append-only

Log Levels

Level	When to Use
Critical	Fatal error causing workflow to stop
Error	Any error that occurred
Warning	Unexpected issue that may need attention
Information	Regular progress logging

Instructions

•Parse the workflow-id, level, step, and message
•Generate timestamp in ISO 8601 format
•Create NDJSON log entry
•Append to agentic/outputs/{workflow-id}/logs.ndjson
•Return confirmation with entry details

Output Guidance

Return JSON confirmation:

json

{
  "success": true,
  "entry": {
    "timestamp": "2024-01-15T10:30:00Z",
    "level": "Information",
    "step": "implement",
    "message": "Completed milestone 1"
  }
}

Templates

Log File Format

Logs are stored in agentic/outputs/{workflow-id}/logs.ndjson as NDJSON:

json

{"timestamp":"2024-01-15T10:30:00Z","level":"Information","step":"implement","message":"Started implementation","context":null}
{"timestamp":"2024-01-15T10:35:00Z","level":"Warning","step":"implement","message":"Rate limit approached","context":{"remaining":10}}