imkohenauser/mtp

# GitHub Repository: imkohenauser/mtp

**URL:** https://github.com/imkohenauser/mtp
**Author:** imkohenauser
**Description:** MTP (Mapping the Prompt): a framework for steering LLM output through sliders, grid coordinates, and presets. 
**Homepage:** https://mappingtheprompt.com/
**Language:** Python

## Stats
- Stars: 5
- Forks: 0
- Open Issues: 0
- Commits: 90
- Created: 2025-08-21T05:45:58Z
- Updated: 2026-06-18T13:26:38Z
- Pushed: 2026-06-18T13:26:12Z

## README
![MTP Doc OGP Image](public/ogp.png)

# MTP (Mapping the Prompt)

MTP is a framework for steering LLM output with grids, sliders, and presets instead of long natural-language behavior instructions.
It is designed to make the ideas and concepts in a prompt easier to express intuitively, helping the user and the LLM align with fewer instructions.


## What is MTP?

Traditionally, changing an AI's tone or behavior often relies on natural-language instructions such as "Act as an expert," "Be more concise," or "Think step by step." These instructions can be ambiguous and may add prompt-side noise that is unrelated to the core task.

MTP moves that behavioral steering into non-verbal parameters such as color, position, and intensity. The MTP Skill makes this framework available through the `/mtp` command, compiling those settings into structured constraints that act as a reasoning-steering filter.

- **Adjust like an EQ** — e.g. `power:100`, `flow:70`, or a grid coordinate such as `J:10`
- **Blend like a Mixer** — named presets (`synthesizer`, `strategist`, …) or explicit multi-grid tokens (e.g. `D:16 A:1`)
- **Change the vibe, not the task** — shift depth, structure, and tone while keeping the base prompt intent intact

```text
/mtp power:100 Summarize this article
/mtp flow:70 Explain this concept
/mtp strategist Compare these options
```

MTP does not change the task itself. It adjusts qualities such as force, flow, depth, structure, openness, and focus.

### How MTP arguments map visually

MTP currently works through the `/mtp` command, but its arguments can be understood visually.

The slider form, `/mtp <node:intensity>`, sets the intensity of a named node such as `power:70` or `flow:100`. The grid form, `/mtp <column:row>`, selects a point on the 19×19 MTP coordinate plane, such as `J:4` or `D:16`.

Both forms describe the same underlying node system: sliders express movement by named direction and intensity, while grid coordinates express position.

#### Color-node files and directional control

![Diagram showing eight Markdown color-node files arranged around a central origin, with Red, Green, White, and Blue defining the cardinal directions.](public/images/pages/mtp-interface-background-from-color-nodes-to-directional-control.png)

*Each direction is defined by a Markdown node file. The center uses `TRANSPARENT.md` as the origin and mediating node.*

| Position | Left        | Center           | Right        |
| -------- | ----------- | ---------------- | ------------ |
| Top      | `YELLOW.md` | `RED.md`         | `MAGENTA.md` |
| Middle   | `GREEN.md`  | `TRANSPARENT.md` | `WHITE.md`   |
| Bottom   | `CYAN.md`   | `BLUE.md`        | `PURPLE.md`  |

#### Node layout and coordinate-plane UI

![MTP coordinate system and node layout diagram](public/images/pages/mtp-coordinate-system-and-node-layout.png)

*Left: the 3×3 MTP node layout, including the paired Side A and Side B directions for each axis. Right: a UI concept for representing the same node space through color and 19×19 grid coordinates, allowing output tendencies to be selected by position rather than by node name.*

---

## MTP Skill quick start

### Install

```bash
# GitHub CLI
gh skill install imkohenauser/mtp skills/mtp

# Vercel Skills CLI
npx skills add imkohenauser/mtp --skill mtp
```

Any **Agent Skills**–compatible host can load the skill; **import steps** differ by vendor — follow your client’s current documentation.

**Requirement:** Python 3 (standard library only — no extra packages).

### Usage

Control the model with sliders, grid coordinates, or presets.

```text
/mtp power:100                  → Moderate force; clearer, more assertive output
/mtp flow:70                    → Full flow; smooth, connected prose
/mtp J:4                        → Equivalent steering to /mtp power:100 (grid coordinate)
/mtp D:16 A:1                   → Multi-grid coordinates
/mtp strategist                 → Preset blend
```

For platform notes, `/mtp` syntax reference, and **References** (CLI docs), see [skills/mtp/README.md](./skills/mtp/README.md).

---

## Documentation

Product documentation, reference, and optional reading are on the documentation site below.

**Mapping the Prompt documentation site (MTP Docs):**  
[mappingtheprompt.com](https://mappingtheprompt.com/)

### Articles

Medium articles by the author, covering the framework and the engineering behind this repository.

- [Mapping the Prompt: Steering LLM Output with a 3x3 Color Grid](https://medium.com/@imkohenauser/mapping-the-prompt-steering-llm-output-with-a-3x3-color-grid-a565452b7022) — an introduction to the MTP framework
- [Packaging an Open Source Agent Skill: CLI Install, ZIP Releases, and Astro/Starlight Docs](https://medium.com/@imkohenauser/packaging-an-open-source-agent-skill-cli-install-zip-releases-and-astro-starlight-docs-8a57e75d8a0c) — how this repository is structured, released, and documented

### For AI agents

During the documentation site build, key pages are aggregated into a single `llms.txt` file. You can provide this file to AI agents to supply them with the context needed to understand and explain the site.

[mappingtheprompt.com/llms.txt](https://mappingtheprompt.com/llms.txt)

---

## Roadmap

- [x] MTP Framework concept [alpha] — 2025-09-01
- [x] MTP Skill [beta] — 2026-03-15
- [x] MTP Docs (Mapping the Prompt documentation site) — 2026-05-05
- [ ] MTP Playlist Skill [in progress]
- [ ] MTP Interactive UI [planned]

---

## License

MIT — [LICENSE](./LICENSE).