Skip to content

feat(skills): Standardize skill output format across all skills #673

@rjmurillo-bot

Description

@rjmurillo-bot

Summary

Define and implement a consistent output format standard for all skill scripts.

Problem Statement

Skill output formats are inconsistent, causing issues:

Evidence:

Requirements

Output Format Standard

  • Define JSON schema for skill success/failure responses
  • Define format for human-readable output
  • Define switching mechanism (-OutputFormat JSON|Human|Auto)
  • Document standard in skill development guide

Implementation

  • Update GitHubCore.psm1 with output helpers
  • Create skill output schema validator
  • Migrate existing skills to standard format (phased)

Acceptance Criteria

  1. Standard documented in skill development guide
  2. Output helpers available in GitHubCore.psm1
  3. At least 3 skills migrated to standard format
  4. JSON output mode returns only valid JSON (no mixed content)

Priority

P2 - Enhancement (prevents recurrence of #632, #639 pattern)

Metadata

Metadata

Assignees

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions