Custom Decorator¶

A meta-decorator that enables user-defined decorator behaviors through explicit rules or instructions. This provides maximum flexibility for creating specialized behaviors not covered by standard decorators.

Category: Meta

Parameters¶

Parameter	Type	Description	Default
`rules`	`string`	Explicit instructions defining the custom behavior (e.g., 'present all examples in a numbered list with exactly three items')	`Required`
`name`	`string`	Optional name for the custom decorator to reference in documentation or explanations	``
`priority`	`enum`	How to prioritize custom rules relative to other decorators	`override`

Priority Options¶

override: These custom rules should override any conflicting instructions from other decorators.
supplement: These custom rules should supplement other decorators, but defer to them in case of direct conflicts.
fallback: Apply these custom rules only when no other decorator provides specific guidance on a particular aspect.

Examples¶

Basic custom formatting rule¶

+++Custom(rules=every paragraph must start with a word that begins with the letter A)
Explain how search engines work.

Provides an explanation of search engines where every paragraph begins with a word starting with the letter A

Complex custom behavior with named reference¶

+++Custom(name=DualPerspective, rules=present two contrasting viewpoints on each main point, label them as 'Perspective A' and 'Perspective B', and then provide a synthesis, priority=supplement)
Analyze the impact of social media on politics.

Analyzes social media's impact on politics using dual contrasting perspectives for each point, labeled as specified, with synthesis after each point, while still respecting other decorators

Model-Specific Implementations¶

gpt-4o¶

Instruction: Follow these custom instructions for your response: {rules}. {name} Apply these custom rules with {priority} priority relative to other formatting guidance.

Notes: This model handles custom instructions well but benefits from clear guidance about how to resolve conflicts with other decorators

Implementation Guidance¶

Basic custom formatting rule for paragraph beginnings¶

Original Prompt:

Explain how search engines work.

Transformed Prompt:

Please apply the following custom formatting or behavior rules to your response: every paragraph must start with a word that begins with the letter A. These custom rules should override any conflicting instructions from other decorators.

Explain how search engines work.

Complex custom behavior with named reference for dual perspectives¶

Original Prompt:

Analyze the impact of social media on politics.

Transformed Prompt:

Please apply the following custom formatting or behavior rules to your response: present two contrasting viewpoints on each main point, label them as 'Perspective A' and 'Perspective B', and then provide a synthesis. This set of custom rules is called 'DualPerspective'. These custom rules should supplement other decorators, but defer to them in case of direct conflicts.

Analyze the impact of social media on politics.

Transformation Details¶

Base Instruction: Please apply the following custom formatting or behavior rules to your response:

Placement: prepend

Composition Behavior: accumulate

Parameter Effects:

rules:
Format: {value}
name:
Format: This set of custom rules is called '{value}'.
priority:
When set to override: These custom rules should override any conflicting instructions from other decorators.
When set to supplement: These custom rules should supplement other decorators, but defer to them in case of direct conflicts.
When set to fallback: Apply these custom rules only when no other decorator provides specific guidance on a particular aspect.

Compatibility¶

Requires: None
Conflicts: None
Compatible Models: gpt-4o
Standard Version: 1.0.0 - 2.0.0

All: Enhances Custom Custom can work with any decorator, with interactions determined by the priority parameter
Priority: Enhances Custom Priority can be used to establish more fine-grained control over how Custom rules interact with other decorators