Promptify

Transform user requests into detailed, precise prompts optimised for AI model consumption.

Core Task

Rewrite the user's request as a clear, specific, and complete prompt that guides an AI model to produce the desired output without ambiguity. Treat the output as specification language, not casual natural language.

Workflow

1. Analyze

Read the user's request carefully. Identify:

The core intent and desired outcome
Missing context (audience, domain, environment)
Unstated constraints (length, tone, format)
Expected output format

2. Structure

Apply the four-block pattern to organise the prompt. See rules/structure-four-block-pattern.md.

Context - Background, audience, domain
Task - What the AI must do
Constraints - Boundaries, rules, limitations
Output Format - Exact structure of the response

Not every prompt needs all four blocks. Use only what adds clarity.

3. Refine

Apply the rules in rules/ to sharpen the prompt:

Replace vague terms with measurable requirements
Add examples where the desired output is ambiguous
Specify exact format (headings, bullet style, length)
Break complex tasks into numbered sequential steps

4. Output

Present the final prompt to the user as a markdown block, clearly labeled. Do not add commentary beyond the prompt itself.

5. Deliver

After presenting the prompt, offer the user two options:

Execute now — Treat the generated prompt as your new instruction and proceed based on the current conversation context. Use your normal judgement to decide the best next action — plan complex tasks, implement simple ones directly, or ask clarifying questions if needed.
Save to file — Write the prompt to a markdown file in the current working directory (e.g. promptify-<timestamp>.md where <timestamp> is epoch seconds). Let the user know the file path.

Writing Guidelines

Structure

Begin with a single short paragraph summarising the overall task
Use headings (##, ###, ####) for sections only where appropriate (no first-level title)
Use bold, italics, bullet points (-), and numbered lists (1., 2.) liberally for organisation
Never use emojis
Never use * for bullet points, always use -

Language

Use plain, straightforward, precise language
Avoid embellishments, niceties, or creative flourishes
Think of language as specification/code, not natural language
Be clear and specific in all instructions

Content

Keep the prompt concise: 0.75X to 1.5X the length of the original request
Do not add or invent information not present in the input
Do not include unnecessary complexity or verbosity

Examples

Positive Trigger

User: "Promptify this: audit all skills against our findings doc."

Expected behavior: Use promptify guidance, follow its workflow, and return actionable output.

Non-Trigger

User: "Generate mock customer data in JSON format."

Expected behavior: Do not prioritize promptify; choose a more relevant skill or proceed without it.

Troubleshooting

Skill Does Not Trigger

Error: The skill is not selected when expected.
Cause: Request wording does not clearly match the description trigger conditions.
Solution: Rephrase with explicit domain/task keywords from the description and retry.

Guidance Conflicts With Another Skill

Error: Instructions from multiple skills conflict in one task.
Cause: Overlapping scope across loaded skills.
Solution: State which skill is authoritative for the current step and apply that workflow first.

Output Is Too Generic

Error: Result lacks concrete, actionable detail.
Cause: Task input omitted context, constraints, or target format.
Solution: Add specific constraints (environment, scope, format, success criteria) and rerun.