Skip to content

Agent skills for useful HTML artifacts, wireframes, interactive prototypes, plans, and diagrams.

Add Codex plugin marketplace manifest (closes #1, Codex part) (#4)

velaswami36220e286bcc
diff --git a/.agents/plugins/marketplace.json b/.agents/plugins/marketplace.json
new file mode 100644
index 0000000..1169554
--- /dev/null
+++ b/.agents/plugins/marketplace.json
@@ -0,0 +1,20 @@
+{
+ "name": "effective-html",
+ "interface": {
+ "displayName": "Effective HTML"
+ },
+ "plugins": [
+ {
+ "name": "plannotator-effective-html",
+ "source": {
+ "source": "url",
+ "url": "https://github.com/plannotator/effective-html.git"
+ },
+ "policy": {
+ "installation": "AVAILABLE",
+ "authentication": "ON_INSTALL"
+ },
+ "category": "Productivity"
+ }
+ ]
+}
diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
new file mode 100644
index 0000000..da8ddf5
--- /dev/null
+++ b/.codex-plugin/plugin.json
@@ -0,0 +1,27 @@
+{
+ "name": "plannotator-effective-html",
+ "version": "0.1.0",
+ "description": "HTML skills for pragmatic visual artifacts — html, html-diagram, and html-plan.",
+ "author": {
+ "name": "plannotator",
+ "url": "https://github.com/plannotator"
+ },
+ "homepage": "https://github.com/plannotator/effective-html",
+ "repository": "https://github.com/plannotator/effective-html",
+ "license": "MIT",
+ "keywords": ["html", "diagram", "plan", "svg", "artifacts", "skills"],
+ "skills": "./skills/",
+ "interface": {
+ "displayName": "Effective HTML",
+ "shortDescription": "Elegant, self-contained HTML plans, diagrams, and artifacts",
+ "longDescription": "Create polished, self-contained HTML artifacts, full-screen architecture diagrams, and pragmatic plan pages from local reference examples.",
+ "developerName": "plannotator",
+ "category": "Productivity",
+ "capabilities": ["Write"],
+ "defaultPrompt": [
+ "Create an effective HTML plan.",
+ "Create an effective HTML diagram.",
+ "Create an effective HTML artifact."
+ ]
+ }
+}
diff --git a/README.md b/README.md
index 94aa266..265fa77 100644
--- a/README.md
+++ b/README.md
@@ -53,6 +53,13 @@ This repo is also a [plugin marketplace](https://code.claude.com/docs/en/plugin-
/plugin install plannotator-effective-html@effective-html
```
+### As a Codex plugin
+
+```bash
+codex plugin marketplace add plannotator/effective-html
+codex plugin add plannotator-effective-html@effective-html
+```
+
## Skills
- `html` - Create an HTML file for whatever the user is describing, matching the effective HTML references.
diff --git a/skills/html-diagram/agents/openai.yaml b/skills/html-diagram/agents/openai.yaml
new file mode 100644
index 0000000..171a409
--- /dev/null
+++ b/skills/html-diagram/agents/openai.yaml
@@ -0,0 +1,7 @@
+interface:
+ display_name: "HTML Diagram"
+ short_description: "Create effective standalone HTML diagrams"
+ default_prompt: "Use $html-diagram to create a polished architecture diagram."
+
+policy:
+ allow_implicit_invocation: false
diff --git a/skills/html-plan/agents/openai.yaml b/skills/html-plan/agents/openai.yaml
new file mode 100644
index 0000000..6a17c9d
--- /dev/null
+++ b/skills/html-plan/agents/openai.yaml
@@ -0,0 +1,7 @@
+interface:
+ display_name: "HTML Plan"
+ short_description: "Create pragmatic visual HTML plans"
+ default_prompt: "Use $html-plan to create a pragmatic HTML plan."
+
+policy:
+ allow_implicit_invocation: false
diff --git a/skills/html/agents/openai.yaml b/skills/html/agents/openai.yaml
new file mode 100644
index 0000000..3a5df66
--- /dev/null
+++ b/skills/html/agents/openai.yaml
@@ -0,0 +1,7 @@
+interface:
+ display_name: "HTML"
+ short_description: "Create effective standalone HTML artifacts"
+ default_prompt: "Use $html to create a polished standalone HTML artifact."
+
+policy:
+ allow_implicit_invocation: false