Skip to content

feat: add Rayfin marketplace plugin (getting-started skill)#15

Open
seanwat-msft wants to merge 4 commits into
microsoft:mainfrom
seanwat-msft:seanwat/rayfin-getting-started-skill
Open

feat: add Rayfin marketplace plugin (getting-started skill)#15
seanwat-msft wants to merge 4 commits into
microsoft:mainfrom
seanwat-msft:seanwat/rayfin-getting-started-skill

Conversation

@seanwat-msft

@seanwat-msft seanwat-msft commented Jun 6, 2026

Copy link
Copy Markdown

What

Adds the official Rayfin agent-skills marketplace plugin to this public repo so UI-first AI coding tools (Claude Code, Copilot, etc.) can install it as a plugin and reference it directly from microsoft/rayfin.

The public plugin ships the pre-scaffold router skill plus the Rayfin MCP server:

  • rayfin-getting-started - a thin router skill for the pre-scaffold gap. It orients the agent to Rayfin, scaffolds a new app via the Rayfin CLI (create-rayfin / rayfin init) when needed, then hands off to the authoritative, version-locked in-project skill that the CLI scaffold writes into the project (.agents/skills/rayfin/SKILL.md). This is what a UI-first tool installs before a project exists.
  • rayfin MCP registration (npx @microsoft/rayfin-mcp).

The in-project rayfin skill is intentionally not bundled here - it is delivered into each project by the scaffold (version-locked to the installed CLI), which is exactly where the router hands off.

Layout

.github/plugin/
  marketplace.json                     # marketplace manifest (plugin: rayfin)
  plugins/rayfin/
    plugin.json                        # plugin manifest + MCP server
    .mcp.json
    skills/rayfin-getting-started/SKILL.md

Notes

  • The validation eval suite is intentionally kept out of this public repo.
  • All references are public (@microsoft/rayfin-* npm packages, the rayfin CLI, public docs, Microsoft Fabric).

Sean Watson and others added 3 commits June 5, 2026 17:32
…ed skill

Introduce the official Rayfin agent-skills marketplace plugin so UI-first AI
coding tools (Claude Code, Copilot, etc.) can install it as a plugin and
reference it directly from this public repo.

The plugin bundles:
- rayfin-getting-started: a thin router skill that orients an agent to Rayfin,
  scaffolds a new app via the Rayfin CLI (create-rayfin / rayfin init) when
  needed, then hands off to the authoritative, version-locked in-project skill.
- rayfin: the authoritative in-project skill covering data modeling, auth,
  storage, querying, DAB config, and Fabric deployment.
- the rayfin MCP server registration (npx @microsoft/rayfin-mcp).

This mirrors the plugin maintained internally; the validation eval suite is
kept out of this public repo by design.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Drop the in-project `rayfin` skill from the public marketplace plugin and
unregister it from plugin.json. The public plugin now ships only the
`rayfin-getting-started` router skill plus the `rayfin` MCP server; the
authoritative in-project skill is delivered into a project by the Rayfin CLI
scaffold (`.agents/skills/rayfin/SKILL.md`), which is where the router hands
off, so nothing is lost.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
The getting-started skill told the agent to always 'cd into the project' after
scaffolding, but that only holds for create-rayfin, which creates a child
project directory. An in-place 'rayfin init' scaffolds in the current
directory, so there's nothing to cd into. Clarify the project-root step for
both paths.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@christopheranderson

Copy link
Copy Markdown
Collaborator

I'm ok with this being done in a follow up PR, but mentioning this in the readme.md/contributing.md would be helpful. Linting/etc. for this we'll add once we bring the rest of the code base in.

…l, drop MCP

The public marketplace plugin ships only the rayfin-getting-started router
skill, so bundling the in-project rayfin MCP server made no sense - that MCP
comes online inside a scaffolded project, not at plugin-install time. Remove
.mcp.json and the mcpServers registration, and reframe the plugin and
marketplace descriptions plus keywords around getting started and scaffolding
via the Rayfin CLI rather than in-project capabilities.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
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.

3 participants