Skip to content

Add get-started skill to skyflow-skills plugin - #24

Merged
jstjoe merged 1 commit into
mainfrom
claude/skyflow-getting-started-skill-cde2f2
Jul 11, 2026
Merged

Add get-started skill to skyflow-skills plugin#24
jstjoe merged 1 commit into
mainfrom
claude/skyflow-getting-started-skill-cde2f2

Conversation

@jstjoe

@jstjoe jstjoe commented Jul 10, 2026

Copy link
Copy Markdown
Contributor

What

Adds a Get Started with Skyflow skill (/skyflow-skills:get-started) to the skyflow-skills plugin. It's the front door for a new Skyflow integration or POC: it orients a new user (and the agent) and then hands off to the right existing skill, rather than doing the integration itself.

Why

New users and agents don't know where to begin — which environment they're in, how to handle credentials safely, or which of the existing skills (plan, create-vault, quickstarts, call-rest-apis, migrate) applies. This skill is a router that removes that friction and bakes in the safety rules from the start.

The flow

The skill walks through, in order (skipping anything already answered):

  1. Account & environment — has an account? trial / sandbox / production? This drives the Management and Vault base URLs (-preview = sandbox) and how carefully to treat data. Points users with no account to the free trial.
  2. Credentials — get an API bearer token in place securely. Explicitly: never ask the user to paste it into the chat, never commit or log it — read it from an env var / gitignored .env / secrets manager. Caution scales with the environment.
  3. Goal — proposes options: explore, plan a full implementation, build a POC, build a production-ready integration, or a specific task.
  4. Mode — offers an educational/collaborative mode and a get-it-done mode, and adapts behavior accordingly.
  5. Hand off — routes the goal to the right skill, API, SDK, docs, and the companion MCP plugins.

Files

  • skyflow-skills-plugin/skills/get-started/SKILL.md — the punchy 5-step orchestration flow + routing table + guardrails.
  • skyflow-skills-plugin/skills/get-started/environments.md — account-type/base-URL matrix, how to find your IDs in Studio, per-environment guidance, common mistakes.
  • skyflow-skills-plugin/skills/get-started/credentials.md — token types (personal token vs API key vs service account), secure local provisioning, and what never to do.

Docs / metadata updates

  • Marketplace README.md and plugin README.md list the new skill.
  • Plugin and marketplace descriptions updated; plugin version bumped 0.5.0 → 0.6.0.
  • CONTRIBUTING.md structure listing includes the new skill directory.

Validation

python3 .github/scripts/validate-skills.py passes for all 7 skills (frontmatter name matches directory, description 359 chars ≤ 1024). The packaging script discovers the skill directory automatically, so it will be included in standalone release zips with its supporting files.

🤖 Generated with Claude Code

https://claude.ai/code/session_01VL1KCtJyvnXQkbwKqc3gEh


Generated by Claude Code

Adds a "Get Started with Skyflow" skill that acts as the front door for
new Skyflow integrations and POCs. It orients the user and agent, then
hands off to the right existing skill.

The skill walks through:
- Account & environment check (trial/sandbox/production -> base URLs)
- Secure credential setup (token stays out of the chat and logs)
- Goal selection (explore / plan / POC / production-ready / specific task)
- Working mode (educational-collaborative vs get-it-done)
- Routing to the appropriate skill, API, SDK, and docs

Supporting references:
- environments.md: account-type/base-URL matrix, finding IDs, per-env cautions
- credentials.md: token types, secure local provisioning, what never to do

Also updates the marketplace README, plugin README, plugin/marketplace
descriptions (version bumped to 0.6.0), and the CONTRIBUTING structure list.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VL1KCtJyvnXQkbwKqc3gEh
@jstjoe
jstjoe merged commit 1a51b0a into main Jul 11, 2026
1 check 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