Skip to content

Add skills marketplace infrastructure#58

Open
jfversluis wants to merge 2 commits intomainfrom
feature/skills-marketplace-infra
Open

Add skills marketplace infrastructure#58
jfversluis wants to merge 2 commits intomainfrom
feature/skills-marketplace-infra

Conversation

@jfversluis
Copy link
Copy Markdown
Member

Closes #51

Summary

Sets up the plugin/marketplace plumbing so this repo can distribute agent skills, compatible with the Copilot CLI / Claude Code / VS Code plugin system. Mirrors dotnet/skills conventions.

This PR is infrastructure only. Actual skills (imported from Redth/maui-skillz) will follow in a separate PR once this merges, so the /evaluate workflow is available on main for proper pipeline evaluation.

What's Included

Marketplace Infrastructure

  • .github/plugin/marketplace. Registry with two pluginsjson
  • plugins/dotnet-maui-devflow/plugin. DevFlow plugin manifestjson
  • plugins/dotnet-maui-dev/plugin. General dev plugin manifest (empty, ready for contributions)json

CI Workflows

  • skill-check. Static validation on PRs (downloads skill-validator AOT binary from dotnet/skills)yml
  • skill-evaluation. LLM-based evaluation gated by /evaluatecomment (write+ permission,issue_comment trigger runs from default branch)yml

Documentation

  • AGENTS. Repo instructions for agentsmd
  • plugins/CONTRIBUTING. Contributor guide with skill format, eval writing guidance, and PR checklistmd
  • plugins/README. Marketplace landing pagemd

Security

  • eng/allowed-external-deps. Reference URL allowlisttxt
  • Evaluation uses env vars (not ${{ }} interpolation) to prevent script injection
  • Write/maintain/admin permission gate for /evaluate

Example Skill

  • devflow- Diagnosing DevFlow agent connectivity (4 eval scenarios)connect

Plugin Structure

Plugin Domain
dotnet-maui-devflow DevFlow automation (requires maui CLI + agent packages)
dotnet-maui-dev General MAUI development (accepting contributions)

Installation (once merged)

/plugin marketplace add dotnet/maui-labs
/plugin install dotnet-maui-devflow@dotnet-maui-labs-skills

Sets up the plugin/marketplace plumbing so this repo can distribute
agent skills, compatible with the Copilot CLI / Claude Code / VS Code
plugin system. Mirrors dotnet/skills conventions.

Infrastructure:
- marketplace.json registry with two plugins (devflow, general dev)
- skill-check.yml: static validation on PRs (skill-validator from dotnet/skills)
- skill-evaluation.yml: LLM-based /evaluate gating with permission checks
- AGENTS.md: repo-level agent instructions
- plugins/CONTRIBUTING.md: contributor guide with evaluation writing guidance
- plugins/README.md: marketplace landing page
- eng/allowed-external-deps.txt: reference URL allowlist

Example skill:
- devflow-connect: DevFlow agent connectivity troubleshooting
- 4 evaluation scenarios testing platform-specific guidance

Closes #51

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds marketplace/plugin scaffolding so this repo can publish distributable “agent skills” as installable plugins, plus CI to validate and (optionally) evaluate skills.

Changes:

  • Introduces marketplace + plugin manifests under .github/plugin/ and plugins/ (with an initial devflow-connect skill).
  • Adds skill validation (skill-check) and gated PR evaluation (skill-evaluation) GitHub Actions workflows.
  • Adds contributor/agent documentation and an external dependency allowlist for skill validation.

Reviewed changes

Copilot reviewed 12 out of 13 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
tests/dotnet-maui-devflow/devflow-connect/eval.yaml Adds evaluation scenarios/assertions for the initial devflow-connect skill.
README.md Documents the new “Agent Skills” marketplace and install commands.
plugins/README.md Adds plugin catalog + install/add-skill guidance.
plugins/dotnet-maui-devflow/skills/devflow-connect/SKILL.md Defines the devflow-connect skill content and workflow.
plugins/dotnet-maui-devflow/plugin.json Declares the DevFlow-focused plugin manifest.
plugins/dotnet-maui-dev/skills/.gitkeep Creates an empty skills folder placeholder for the general MAUI plugin.
plugins/dotnet-maui-dev/plugin.json Declares the general MAUI plugin manifest.
plugins/CONTRIBUTING.md Adds skill authoring + evaluation authoring guidance and checklist.
eng/allowed-external-deps.txt Adds allowlist file for validator-controlled external deps.
AGENTS.md Adds repo instructions for agents + skill authoring/build pointers.
.github/workflows/skill-evaluation.yml Adds gated /evaluate workflow + commit status plumbing and PR reporting.
.github/workflows/skill-check.yml Adds PR/push static validation using skill-validator check.
.github/plugin/marketplace.json Registers the repo marketplace and its plugins.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

- Use process substitution instead of piped while loop so EVAL_FAILED
  persists outside the subshell
- Handle gh api 404 for non-collaborators gracefully (fall back to 'none')
- Deduplicate evaluation by running once per plugin instead of once per skill

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.

Add marketplace/plugin capabilities

2 participants