From ee3f45b9c1affe34e36fd25db81509481b1dd7f7 Mon Sep 17 00:00:00 2001 From: Guillaume Lebedel Date: Thu, 19 Nov 2026 02:12:05 +0000 Subject: [PATCH 1/2] feat: guide connected-app workflows with a StackOne skill --- .antigravity-plugin/plugin.json | 6 +++--- .codex-plugin/plugin.json | 6 +++--- .github/workflows/validate.yml | 6 +++--- README.md | 13 ++++++++----- scripts/validate-grok.py | 2 +- skills/stackone-actions/SKILL.md | 15 +++++++++++++++ 6 files changed, 33 insertions(+), 15 deletions(-) create mode 100644 skills/stackone-actions/SKILL.md 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..10f4145 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) 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. From cbd81b3f67242cee318194b22911d051324bfb4d Mon Sep 17 00:00:00 2001 From: Guillaume Lebedel Date: Thu, 19 Nov 2026 02:22:47 +0000 Subject: [PATCH 2/2] test: verify Claude discovers the bundled workflow --- .github/workflows/validate.yml | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/.github/workflows/validate.yml b/.github/workflows/validate.yml index 10f4145..b1887d9 100644 --- a/.github/workflows/validate.yml +++ b/.github/workflows/validate.yml @@ -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)