fix(SOL-418): stackone-connect - update stale StackOne docs links and hub guidance

[faisalreza-stackone]

Summary

StackOne moved the account linking docs under /embed/, which broke the docs links in the stackone-connect skill. guides/connect-tools-overview, guides/webhooks and guides/embedding-stackone-hub now redirect, and the npm page for @stackone/hub returns 403 to automated fetches. Some facts in the skill had also gone stale, for example Auth Links being "valid 5 days" (the dashboard default is now 30 days and the API takes expires_in) and the Hub's csv-importer mode.

Changes

• Current pages: the skill points to the Embed pages: Account Linking, StackOne Hub (React), Connect Session, Auth Link and Handle Account Events. The account check uses the v2 Get An Account reference.
• Durable links: appending .md returns a page as markdown. If a URL 404s, the agent searches the "Embed" section of llms.txt by topic. The Hub repository README is the fallback for the package itself.
• Facts come from the docs: props, peer dependencies and link expiry are no longer restated in the skill. references/hub-reference.md is deleted because it duplicated the StackOne Hub (React) page and had drifted from it.
• Additions from the current docs:
  • the <stackone-hub> web component for non-React apps
  • the warning to set origin_owner_id on the server
  • a troubleshooting note that account events are subscribed on the webhook itself, not on a connector profile
• Skill metadata.version bumped from 2.0 to 2.1. The plugin version is left to release-please.

Files

File	Change
plugins/integrations/stackone-connect/skills/stackone-connect/SKILL.md	Links, fallback, method table, examples, troubleshooting
plugins/integrations/stackone-connect/skills/stackone-connect/references/hub-reference.md	Deleted

Test plan

• Every URL in SKILL.md returns 200 directly (no redirects)
• claude plugin validate . passes
• The stackone-connect eval cases (embed-hub-in-react, oauth-app-whose-credentials) pass on Claude Sonnet, and the React case now fetches only current pages instead of redirected and guessed paths

🤖 Generated with Claude Code

---

Summary by cubic

Updates the stackone-connect skill after StackOne moved account linking docs under /embed/, which broke several links and left facts like Auth Link expiry and Hub modes stale.

• Docs links now point to current Embed pages, fetched as markdown by appending .md; if a page 404s, the skill falls back to llms.txt and the Hub repo README, and tells the agent to contact StackOne support rather than inventing an answer.
• Deletes references/hub-reference.md, which duplicated and drifted from the StackOne Hub page; props, peer dependencies, link expiry, and the account event table are now taken from the docs instead of restated.
• Adds the <stackone-hub> web component, a warning to set origin_owner_id server-side, and a troubleshooting note that account events are subscribed on the webhook itself.
• Bumps skill metadata.version from 2.0 to 2.1.

^{Written for commit f959a0c. Summary will update on new commits.}

[Copilot]

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

[cubic-dev-ai]

All reported issues were addressed across 2 files

<sub>Reply with feedback, questions, or to request a fix.

Re-trigger cubic</sub>

[cubic-dev-ai]

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

<sub>Auto-approved: Updates the stackone-connect skill's docs links to StackOne's current /embed/ pages, adds llms.txt and Hub README fallbacks, removes the drifted hub-reference.md, and bumps the skill version. This is a bounded documentation correction fixing broken links and stale facts.

Re-trigger cubic</sub>

[cubic-dev-ai]

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

<sub>Auto-approved: Bounded documentation/skill update: rewires stackone-connect to StackOne's current /embed/ pages, adds llms.txt and Hub README fallbacks, instructs the agent not to invent answers, deletes the drifted hub-reference.md, and bumps the skill version. No runtime behavior, rollout, or contract changes.

Re-trigger cubic</sub>

[cubic-dev-ai]

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

<sub>Auto-approved: Bounded documentation update to the stackone-connect skill: rewires links to current StackOne /embed/ docs, removes the drifted hub-reference.md and stale event table, adds fallback guidance, and bumps the skill version. No runtime, rollout, or contract changes.

Re-trigger cubic</sub>