diff --git a/pstack/README.md b/pstack/README.md
index cbe932ae..e0fbee66 100644
--- a/pstack/README.md
+++ b/pstack/README.md
@@ -18,6 +18,8 @@ fork it. improve it. make it yours. PRs are welcome!
 /add-plugin pstack
 ```
 
+pstack also includes a root [`plugin.json`](./plugin.json) for [Agent Plugins v1](https://agent-plugins.org/specification) clients. use your client's plugin flow to install the `pstack/` directory. the portable package exposes the skills under `skills/`; the two subagents under `agents/` remain cursor-specific.
+
 ## get started
 
 two steps:
diff --git a/pstack/plugin.json b/pstack/plugin.json
new file mode 100644
index 00000000..56603fdf
--- /dev/null
+++ b/pstack/plugin.json
@@ -0,0 +1,21 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "pstack",
+  "version": "0.14.2",
+  "description": "if you want to go fast, go deep first. pstack helps you write less, but higher quality code. rigorous agent workflows you can parallelize with confidence.",
+  "author": {
+    "name": "Lauren Tan"
+  },
+  "homepage": "https://github.com/cursor/plugins/tree/main/pstack",
+  "repository": "https://github.com/cursor/plugins",
+  "license": "MIT",
+  "keywords": [
+    "pstack",
+    "poteto-mode",
+    "workflow",
+    "principles",
+    "agent-style",
+    "subagents",
+    "unslop"
+  ]
+}
diff --git a/pstack/skills/poteto-mode/SKILL.md b/pstack/skills/poteto-mode/SKILL.md
index a74065cd..614cb1e7 100644
--- a/pstack/skills/poteto-mode/SKILL.md
+++ b/pstack/skills/poteto-mode/SKILL.md
@@ -1,11 +1,13 @@
 ---
-name: Poteto Mode
+name: poteto-mode
 description: poteto's agent style for concise, detailed responses, deliberate subagents, unslopped prose, simple code, and verified work. Use for poteto, /poteto-mode, or requests to work in this style.
 disable-model-invocation: true
 mode: true
 icon: crown
 color: yellow
 reminder: New task? Playbook match or rigor needed -> apply /poteto-mode. Casual turn or user opts out -> don't.
+metadata:
+  cursor-display-name: Poteto Mode
 ---
 
 # Poteto mode