messages

Add new message types to the safe-output system across JSON schema, Go, and JavaScript.

4.9k|489|Updated Aug 12, 2025
One-click install
npx skills add https://github.com/githubnext/gh-aw --skill messages
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: messages
Source: https://github.com/githubnext/gh-aw/tree/main/skills/messages
Command: npx skills add https://github.com/githubnext/gh-aw --skill messages

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides developers through the process of adding new custom message types to the GitHub Agentic Workflows safe-output system, enabling richer and more tailored communication from AI agents. It helps enhance user feedback and interaction within automated workflows.

Core Features & Use Cases

  • Schema & Struct Updates: Learn to update JSON schema and Go structs to define new message fields.
  • JavaScript Module Creation: Create dedicated JavaScript modules for message generation, supporting custom templates and default messages.
  • Go Embedding & Bundling: Integrate new JavaScript message modules into the Go binary for seamless bundling and execution.
  • Comprehensive Testing: Add unit tests to ensure new message types function as expected.
  • Use Case: A developer wants to add a new custom message for when an AI agent closes an older discussion. This skill provides a step-by-step guide to integrate close-older-discussion into the message system.

Quick Start

Consult the messages skill to add a new my-new-message field to the JSON schema and Go struct for safe-output messages.

Frequently Asked Questions about messages

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

FAQPage Schema
How do I add a new message type to GitHub Agentic Workflows?

Add a new message type by updating the JSON schema and Go structs, creating a JavaScript module for message generation, integrating it into the Go binary, and adding tests. The Skill guides you through each step to enable custom safe-output messages across your workflows.

What's involved in extending the safe-output messages system?

Extending safe-output messages requires updates to frontmatter YAML fields, JSON Schema definitions, Go parsing and compilation, JavaScript modules, and bundling logic. This Skill covers the complete workflow from schema definition through testing and embedding.

Can I create custom message templates for AI agent feedback?

Yes. This Skill shows how to create dedicated JavaScript modules with custom templates and default messages, then embed them into the Go binary. You can tailor message output for specific agent actions like closing discussions or custom notifications.

Do I need to update both Go and JavaScript to add a message type?

Yes. Adding a message type requires both Go struct and parser updates for schema handling, and JavaScript module creation for template generation. The Skill provides guidance on coordinating changes across both layers for seamless integration.

How do I test new message types in the safe-output system?

Add unit tests alongside your message implementation. This Skill includes best practices for testing new message types to ensure they function correctly within GitHub Agentic Workflows before deployment.

What's the typical workflow for implementing a custom message?

Start by consulting the messages Skill to add your message field to the JSON schema and Go struct, create a JavaScript module with templates, integrate it into the Go binary through embedding and bundling, then write and run tests to verify functionality.