From d6187dc0f80a9da06f36bceda02761a255aa6205 Mon Sep 17 00:00:00 2001 From: Marc Sloan Date: Tue, 7 Jul 2026 16:37:55 +0100 Subject: [PATCH] docs(plugin-creator): public-ready README, bump to 0.1.1 Remove internal draft/review framing and working-name caveat from the README; add an Install section. Patch bump so the change publishes. Co-Authored-By: Claude Opus 4.8 (1M context) --- plugin-creator/.tessl-plugin/plugin.json | 2 +- plugin-creator/README.md | 22 ++++++++++++++-------- 2 files changed, 15 insertions(+), 9 deletions(-) diff --git a/plugin-creator/.tessl-plugin/plugin.json b/plugin-creator/.tessl-plugin/plugin.json index 16e6335..e2065a4 100644 --- a/plugin-creator/.tessl-plugin/plugin.json +++ b/plugin-creator/.tessl-plugin/plugin.json @@ -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/" diff --git a/plugin-creator/README.md b/plugin-creator/README.md index 2614eab..de240d8 100644 --- a/plugin-creator/README.md +++ b/plugin-creator/README.md @@ -1,10 +1,16 @@ -# 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 @@ -12,13 +18,13 @@ understand → gather → plan the composition → build → (then, separately) | 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.