Skip to content

fix(SOL-421): stackone-cli - update stale StackOne docs links and connector workflow - #41

Merged
faisalreza-stackone merged 3 commits into
mainfrom
fix/sol-421-cli-docs-links
Sep 29, 2026
Merged

faisalreza-stackone merged 3 commits into
mainfrom
fix/sol-421-cli-docs-links

Conversation

@faisalreza-stackone

@faisalreza-stackone faisalreza-stackone commented Sep 28, 2026 •

Copy link
Copy Markdown
Contributor

Summary

StackOne moved the connector-building docs, which broke every docs link in the stackone-cli skill. The old guides/connector-engine/* pages now redirect or fail (the connector structure page returned 504), and the AI Builder page no longer exists. The skill also described a workflow (Connector Engine scaffolding, AI Builder) that has since been replaced by the CLI's agent setup and onboarding command.

Changes

  • First Connector is the main instructions: the skill points to docs.stackone.com/connector-building/first-connector and tells the agent to follow its steps in order. It no longer restates the setup commands, so a change to the workflow needs no skill edit.
  • Other topics route to Connector Building pages: customizing an existing connector, build workflow and debugging, CLI reference, GitHub CI/CD and connector versioning. YAML questions go to the Connector YAML Reference.
  • Durable links: appending .md returns a page as markdown, and if a URL 404s the agent searches llms.txt by topic for the current page.
  • Removed stale terms: "Connector Engine" and "AI Builder" are gone from the skill body, the plugin README, plugin.json and the marketplace.json entry.
  • Skill metadata.version bumped from 2.0 to 2.1. The plugin version is left to release-please.

Files

File Change
plugins/integrations/stackone-cli/skills/stackone-cli/SKILL.md Links, workflow, description
plugins/integrations/stackone-cli/README.md Description, example prompts
plugins/integrations/stackone-cli/.claude-plugin/plugin.json Description
.claude-plugin/marketplace.json stackone-cli entry description

Test plan

  • Every docs.stackone.com URL in SKILL.md returns 200 directly (no redirects)
  • Every page title the skill routes to appears in the Connector Building or Connector YAML Reference section of llms.txt
  • claude plugin validate . passes

🤖 Generated with Claude Code


Summary by cubic

Updates the stackone-cli skill after StackOne reorganized its connector-building docs, which broke every docs link and the described workflow (Connector Engine scaffolding, AI Builder).

  • Makes the First Connector guide the source of truth for setup, so workflow changes no longer require editing the skill.
  • Points the skill at the new Connector Building pages and adds an llms.txt fallback for pages that 404, fetching .md pages as-is.
  • Removes stale "Connector Engine" and "AI Builder" references from the skill, README, and plugin and marketplace descriptions.
  • Bumps the skill version to 2.1.

Written for commit 409feaa. Summary will update on new commits.

Review in cubic

…rkflow

- connector-engine guide links -> connector-building pages
- First Connector as the main instructions, no restated flow
- drop AI Builder and Connector Engine references
- llms.txt fallback for moved pages
- skill metadata.version 2.0 -> 2.1

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Copilot AI lite review requested due to automatic review settings September 28, 2026 11:28

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@cubic-dev-ai cubic-dev-ai Bot left a comment •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All reported issues were addressed across 4 files

Reply with feedback, questions, or to request a fix.

Re-trigger cubic

Comment thread plugins/integrations/stackone-cli/skills/stackone-cli/SKILL.md
Comment thread plugins/integrations/stackone-cli/skills/stackone-cli/SKILL.md
Comment thread plugins/integrations/stackone-cli/skills/stackone-cli/SKILL.md Outdated
faisalreza-stackone and others added 2 commits September 28, 2026 12:32
- llms.txt fetched as is, no .md suffix
- .md on connectors/introduction link
- First Connector URL in example 1

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- .md suffix only for urls not already ending in .md
- contact support when docs do not cover it

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

0 issues found across 1 file (changes from recent commits).

Auto-approved: Updates the StackOne CLI skill, README, and plugin/marketplace descriptions to point at the current connector-building docs and removes the stale Connector Engine/AI Builder workflow. Docs-only change with an llms.txt fallback; no code or operational behavior changes.

Re-trigger cubic

@faisalreza-stackone
faisalreza-stackone merged commit a9b0d46 into main Sep 29, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants