diff --git a/.antigravity-plugin/plugin.json b/.antigravity-plugin/plugin.json
index 71db066..402fa1e 100644
--- a/.antigravity-plugin/plugin.json
+++ b/.antigravity-plugin/plugin.json
@@ -19,8 +19,8 @@
"stackone actions"
],
"suggestedPrompts": [
- "Use StackOne to list the accounts I have connected.",
- "Use StackOne to find and run the action that creates a Jira issue.",
- "Use StackOne to pull my open Workday time-off requests."
+ "Which apps do I have connected through StackOne?",
+ "Use StackOne to show me the five most recently updated records in a connected app.",
+ "Help me update a record through StackOne. Show me the proposed change before saving it."
]
}
diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
index 0a01a8e..ee90716 100644
--- a/.codex-plugin/plugin.json
+++ b/.codex-plugin/plugin.json
@@ -34,9 +34,9 @@
"composerIcon": "./assets/logo.png",
"brandColor": "#000000",
"defaultPrompt": [
- "Use StackOne to list the accounts I have connected.",
- "Use StackOne to find and run the action that creates a Jira issue.",
- "Use StackOne to pull my open Workday time-off requests."
+ "Which apps do I have connected through StackOne?",
+ "Use StackOne to show me the five most recently updated records in a connected app.",
+ "Help me update a record through StackOne. Show me the proposed change before saving it."
]
}
}
diff --git a/.github/workflows/validate.yml b/.github/workflows/validate.yml
index cdd173d..b1887d9 100644
--- a/.github/workflows/validate.yml
+++ b/.github/workflows/validate.yml
@@ -45,15 +45,15 @@ jobs:
"https://storage.googleapis.com/antigravity-public/antigravity-cli/$AGY_BUILD/linux-x64/cli_linux_x64.tar.gz" -o agy.tar.gz
echo "$AGY_SHA512 agy.tar.gz" | sha512sum --check
tar -xzf agy.tar.gz antigravity
- - name: Validate the bundle and check the installed MCP server
+ - name: Validate the bundle and check the installed skill and MCP server
shell: bash
run: |
"$RUNNER_TEMP/antigravity" plugin validate --json . | jq -e '
- .manifest == ".antigravity-plugin/plugin.json" and .components.mcpServers == 1 and
+ .manifest == ".antigravity-plugin/plugin.json" and .components.mcpServers == 1 and .components.skills >= 1 and
all(.findings[]; .severity == "warning" and (.file == ".mcp.json" or .file == "mcp.json"))'
"$RUNNER_TEMP/antigravity" plugin install .
"$RUNNER_TEMP/antigravity" plugin list --json | jq -e '
- any(.[]; .name == "stackone" and .enabled and .mcpServers == ["stackone"])'
+ any(.[]; .name == "stackone" and .enabled and .mcpServers == ["stackone"] and (.skills | index("stackone-actions") != null))'
claude-code:
name: Claude Code (claude plugin validate + install from source)
@@ -76,7 +76,7 @@ jobs:
run: |
claude plugin validate .claude-plugin/plugin.json
claude plugin validate .claude-plugin/marketplace.json
- - name: install from this repo as a marketplace and confirm the MCP server is detected
+ - name: install from this repo as a marketplace and confirm the skill and MCP server are detected
env:
CLAUDE_CONFIG_DIR: ${{ runner.temp }}/claude
run: |
@@ -84,7 +84,8 @@ jobs:
claude plugin install stackone@stackone
claude plugin details stackone@stackone | tee details.txt
grep -q "MCP servers (1)" details.txt
- grep -q "Skills (0)" details.txt
+ grep -q "Skills (1)" details.txt
+ grep -q "stackone-actions" details.txt
codex:
name: Codex / ChatGPT (install from source)
diff --git a/README.md b/README.md
index 5c13fc8..bc11f61 100644
--- a/README.md
+++ b/README.md
@@ -31,18 +31,20 @@ The server exposes four tools:
| `stackone_list_accounts` | List the accounts (Workday, Salesforce, Notion, Jira, …) linked to your session and their ids. |
| `stackone_submit_feedback` | Report a tool result that was wrong or unhelpful. |
-Example prompts once connected:
+### Try it with your connected apps
-- "List the accounts I have connected through StackOne."
-- "Use StackOne to find my open Workday time-off requests."
-- "Create a Jira issue for the bug we just discussed, via StackOne."
+- “Which apps do I have connected through StackOne?”
+- “Use StackOne to show me the five most recently updated records in a connected app.”
+- “Help me update a record through StackOne. Show me the proposed change before saving it.”
+
+In Antigravity, you can also type `/stackone-actions` and describe a task. The [workflow](skills/stackone-actions/SKILL.md) finds actions available to your account, uses their input schemas, and previews changes for approval.
## Authentication and data
- **Auth:** OAuth 2.1 with PKCE against `https://idp-api.stackone.com/api/auth`. The server takes either kind of client the host brings: a URL-based client ID backed by a client ID metadata document, or one from dynamic client registration. On first use your host opens the StackOne sign-in page. No API keys or secrets live in this repo.
- **Scopes:** `mcp`, `offline_access` (refresh tokens so you sign in once).
- **Network endpoints this plugin calls:** `mcp.stackone.com` (the MCP server) and `idp-api.stackone.com` (sign-in). Nothing else.
-- **What runs locally:** nothing. No hooks, no scripts, no bundled binaries. The plugin is a manifest and a server URL.
+- **What runs locally:** nothing. No hooks, no scripts, no bundled binaries. The bundled skill is Markdown. StackOne runs the actions on its hosted MCP server.
- **Data:** actions run against the SaaS accounts you have linked in StackOne, under the permissions of that link. Privacy policy: . Terms: .
## Repository layout
@@ -61,6 +63,7 @@ stackone-plugin/
├── mcp_config.json # server config read by Antigravity
├── mcp.json # server config read by Cursor
├── .mcp.json # server config read by Claude Code, Grok Build, Codex
+├── skills/stackone-actions/SKILL.md # Connected-app workflow
├── assets/logo.png, logo.svg
└── scripts/check-manifests.py
```
diff --git a/scripts/validate-grok.py b/scripts/validate-grok.py
index 7c92b31..40f1bab 100755
--- a/scripts/validate-grok.py
+++ b/scripts/validate-grok.py
@@ -33,7 +33,7 @@ def load(name, rel):
errors.append(f"xAI extractor sees transport {servers[0].get('description')!r}, expected 'http'")
for k in ("hooks", "lspServers", "commands", "agents"):
if extracted.get("components", {}).get(k):
- errors.append(f"plugin unexpectedly ships {k}: {extracted['components'][k]} (this plugin is MCP-only)")
+ errors.append(f"plugin unexpectedly ships {k}: {extracted['components'][k]}")
entry = json.loads((repo / "marketplace/xai-catalog-entry.json").read_text())
sha = os.environ.get("GITHUB_SHA") or subprocess.check_output(["git", "rev-parse", "HEAD"], cwd=repo, text=True).strip()
diff --git a/skills/stackone-actions/SKILL.md b/skills/stackone-actions/SKILL.md
new file mode 100644
index 0000000..9301cd1
--- /dev/null
+++ b/skills/stackone-actions/SKILL.md
@@ -0,0 +1,15 @@
+---
+name: stackone-actions
+description: Use StackOne to discover connected apps, look up records, or make a user-approved change in a connected account.
+---
+
+# Work with connected apps through StackOne
+
+For “what do I have connected?”, call `stackone_list_accounts` and show the app and account names. If the list is empty, explain that the user needs to link an account in StackOne. If the tool requires sign-in, direct the user to the host’s StackOne sign-in control.
+
+For a task in a connected app:
+
+1. Describe the task to `stackone_search_actions`. Narrow by provider when the user names an app. Use the returned `available_accounts` to identify the destination. If several accounts fit and the request leaves the choice open, ask which one to use.
+2. Build the request from the selected action’s `example_request` and `input_schema`. Keep the returned `action_id` and `session_id`, fill the required fields with real values, and pass the selected `stackone_account_id` when needed. Resolve a record by searching or listing it if the user supplied a name. Ask when multiple records match.
+3. For a lookup, call `stackone_execute_action` and summarize the requested results. Honor filters, ordering, and limits supported by the action. If you cannot establish which records are most recent, say so. For a change, show the account, target and proposed values. Execute only after the user approves that specific change. A request for a draft ends at the preview.
+4. Report what the tool confirmed, with the record link or ID when available. If a write times out, check the target before retrying to avoid applying the change twice.