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.