Skip to content

docs(plugin-creator): public-ready README (v0.1.1) #18

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
marc-tessl merged 1 commit into from
Jul 7, 2026
Merged

docs(plugin-creator): public-ready README (v0.1.1) #18

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion plugin-creator/.tessl-plugin/plugin.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "tessl/plugin-creator",
"version": "0.1.0",
"version": "0.1.1",
"description": "Create a Tessl plugin: wrap your existing skills into a versioned, shareable bundle, decide what else it needs (rules, commands, MCP servers), validate, and publish.",
"private": false,
"skills": "./skills/"
Expand Down
22 changes: 14 additions & 8 deletions plugin-creator/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,24 +1,30 @@
# plugin-creator (working name)
# plugin-creator

> First draft, not published. Built for Marc to review. Working name only, this is not plugin-first. See `DRAFT-NOTES.md`.
Turn a problem, or a messy existing skill, into well-shaped agent context. plugin-creator understands what you are trying to do, takes stock of what you already have, plans the right shape (a single skill, or a plugin with rules and MCP servers), and builds it. Evaluation is a separate, downstream step handled by `tessl/skill-optimizer`; this gets you to a well-formed composition first.

Turn a problem, or a messy existing skill, into well-shaped agent context. It understands what you are trying to do, takes stock of what you already have, plans the right shape (a single skill, or a plugin with rules and MCP servers), and builds it. Evaluation is a separate, downstream step, handled by `tessl/skill-optimizer`; this gets you to a well-formed composition first.
## Install

## The arc
```bash
tessl install tessl/plugin-creator
```

Then just tell your agent what you want it to do better.

## How it works

understand → gather → plan the composition → build → (then, separately) eval

## Skills

| Skill | Description |
|-------|-------------|
| `create-context` | Orchestrator. Runs the arc and points to eval at the end. |
| `gather-context` | Understand the problem and take stock of what exists; fill gaps by asking, hunting (PRs/logs), or inferring. |
| `create-context` | Orchestrator. Runs the flow and points to eval at the end. |
| `gather-context` | Understand the problem and take stock of what exists; fill gaps by asking, hunting (PRs and logs), or inferring. |
| `plan-composition` | Decide the shape: a single skill, or a plugin with the right primitives. |
| `build-composition` | Create it, scaffolding with the CLI, not hand-written manifests. |
| `build-composition` | Create it, scaffolding with the CLI rather than hand-written manifests. |
| `decompose-into-skills` | Split a big skill into focused, independently-verifiable skills. |
| `publish-plugin` | Optional. Publish or re-publish to the registry. |

## Companion

For quality (review, eval scenarios, optimisation), `tessl/skill-optimizer` is the sibling flow, after a composition is built.
For quality (review, eval scenarios, optimisation), `tessl/skill-optimizer` is the sibling flow, once a composition is built.