authoring-decorators

Define and implement prompt decorators with JSON schema and verification.

42|10|Updated Feb 28, 2025
One-click install
npx skills add https://github.com/synaptiai/prompt-decorators --skill authoring-decorators
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: authoring-decorators
Source: https://github.com/synaptiai/prompt-decorators/tree/main/claude-code-plugin/skills/authoring-decorators
Command: npx skills add https://github.com/synaptiai/prompt-decorators --skill authoring-decorators

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Authoring Decorators provides a guided process to create new prompt decorators, including how to structure the JSON schema, where to place the file, how to verify it end-to-end, and how to test for personal use or upstream contributions.

Core Features & Use Cases

  • Step-by-step workflow from prerequisites to end-to-end verification for new decorators.
  • Clear guidance on personal versus upstream deployments, registry placement, and testing requirements.
  • Best-practice recommendations for safe, verifiable decorators in real projects.

Quick Start

Create a new decorator JSON under your user registry or submit a PR to upstream and verify it with the hook and preview commands.

Frequently Asked Questions about authoring-decorators

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

FAQPage Schema
How do I create a new prompt decorator using JSON schema?▼

To create a prompt decorator, define a JSON file adhering to decorator_schema.json with required fields including decoratorName, version, description, and transformationTemplate. Place the file in your personal user registry or submit a pull request to the upstream registry.

What is the correct structure for a prompt decorator JSON file?▼

A prompt decorator JSON file must conform to decorator_schema.json, requiring specific fields: decoratorName, version, description, and transformationTemplate. Proper labeling and placement within the designated registry directory are also necessary for validation.

How do I verify and test a prompt decorator end-to-end?▼

Verify a prompt decorator by running accompanying tests or smoke tests using hook and preview commands. End-to-end verification ensures the transformationTemplate applies correctly to prompts before deploying to a personal or upstream registry.

Can I submit prompt decorators to an upstream registry?▼

Yes, you can submit decorators to an upstream registry by creating a pull request. The submission must include a properly structured JSON file following decorator_schema.json and accompanying tests to verify behavior and ensure safe contributions.

What are the requirements for deploying prompt decorators in personal registries?▼

Deploying to a personal registry requires creating a JSON file under your user registry directory, ensuring it adheres to decorator_schema.json with proper fields like decoratorName and transformationTemplate, and verifying functionality with smoke tests.

Why does my prompt decorator fail validation during registry placement?▼

Decorator validation fails when the JSON file does not adhere to decorator_schema.json or is missing required fields like decoratorName, version, description, or transformationTemplate. Ensure proper labeling and run end-to-end verification to resolve schema mismatch issues.