SuperAPI AI Directory

compose-instruction

Writing & research

View repository

Updated 10-16 03:48

About this skill

Compose Writing Instruction

Compose a writing instruction by combining taxonomy entries from the Voice and Tone, Style, and Format axes.

Usage

/writing-style-catalog:compose-instruction [voice=<id>] [tone=<id>] [style=<id>] [format=<id>] [topic=<text>] [audience=<text>]

All parameters are optional. If omitted, the skill picks sensible defaults.

Parameters

  • voice - Voice entry ID (e.g., pragmatic-architect, pastoral, columnist)
  • tone - Tone entry ID (e.g., candid, warm, matter-of-fact)
  • style - Style entry ID (e.g., problem-solution, devotional-reflection)
  • format - Format entry ID (e.g., adr, blog-post-long-form, slack-message)
  • topic - The topic or subject to write about (optional, for a more concrete composed instruction)
  • audience - The intended audience (optional, defaults to general)

What the Skill Does

  1. Validates each provided entry ID against the taxonomy catalog
  2. Reads the llm_instruction_phrasing from each matching entry
  3. Assembles a composed instruction string that specifies voice, tone, style, and format together
  4. Returns the composed instruction ready to paste into any LLM prompt

Implementation

The composition is implemented by the helper script scripts/build-instruction.py in this skill folder. It reads the catalog from the taxonomy/ directory at the plugin root, so that directory ships with the plugin. The slash command takes key=value arguments; the script itself takes --flag value arguments. Run it directly to compose without the slash command, for example:

python scripts/build-instruction.py --voice pragmatic-architect --tone candid --format adr

Examples

Compose an ADR in pragmatic-architect voice with candid tone:

/writing-style-catalog:compose-instruction voice=pragmatic-architect tone=candid format=adr

Compose a pastoral devotional:

/writing-style-catalog:compose-instruction voice=pastoral tone=reverent style=devotional-reflection format=devotional-entry topic="The discipline of rest"

Available Entries

Run without arguments to see all available entries grouped by axis.