kingbootoshi/directional-prompting

README preview

# Directional Prompting

<p align="center">
  <img src="plugins/directional-prompting/skills/directional-prompting/assets/hero.jpeg" alt="Vibe Bot walking a glowing path that Bootoshi is pointing toward, with the words 'Directional Prompting — name the path. the trees disappear.'" width="900">
</p>

A two-layer skill for writing prompts, agent directives, skill descriptions, slash commands, and anywhere else an LLM reads instructions. Works the same in **Claude Code** and **OpenAI Codex CLI**.

Same `SKILL.md`, same trigger surface, same outcome. Drop it into `~/.claude/skills/directional-prompting/` and `~/.codex/skills/directional-prompting/` and both agents pick it up natively.

## The two layers

**Layer 1 — Outcome.** Every non-trivial prompt opens with a block that names the destination: the goal, what "done" looks like, when to stop, the true invariants. This is the frame.

**Layer 2 — Direction.** Inside that frame, every sentence names the path forward with positive verbs. "Trace", "build", "use", "read", "return", "ask", "check". The correct behavior is described so clearly and completely that the wrong behavior has no room to exist.

Outcome without direction reads as wishful — the model knows where to go but not how to step. Direction without outcome wanders — the model walks crisp paths to nowhere. Both layers together: a model that knows the destination and walks toward it on every token.

## Why both labs converge here

View full repository on GitHub →