Skip to content

docs: lead with the MCP server and specify skill packaging - #7

Closed
juandresrodca wants to merge 1 commit into
claude/project-continuation-494960from
claude/mcp-first-readme
Closed

juandresrodca wants to merge 1 commit into
claude/project-continuation-494960from
claude/mcp-first-readme

Conversation

@juandresrodca

Copy link
Copy Markdown
Owner

Stacked on #6. Both change the same README lines, so this PR is based on #6's branch. Merge #6 first; GitHub then retargets this PR to main.

Why

The MCP server is the capability flat-list assignment tools do not have, and it sat below the demo GIF. The self-contained viewer was only mentioned in passing under Permissions. This change makes both visible on the first screen, and specifies how the same six tools would ship as a Claude Code plugin with a skill.

What changed

  • README order: Try it (the no-tenant demo command stays first, as docs/discoverability.md records) → Ask your AI why (the MCP section, moved up and no longer headed "New:") → One HTML file, zero network calls (the GIF, plus the viewer described as a feature) → The three questions it answers.

  • Tagline: now names the self-contained viewer and the bundled MCP server.

  • docs/skill.md: the plugin specification.

    • .claude-plugin/plugin.json, with the snapshot path as a userConfig file prompt and the existing launcher through ${CLAUDE_PLUGIN_ROOT}.
    • The marketplace entry.
    • The same six tools, unchanged.
    • The full SKILL.md.
    • A shipping checklist.

    Its status line says specified, not shipped, and the README says the same. It is checked against the Claude Code plugin, marketplace and skills reference.

  • docs/discoverability.md: records the new repository description, which puts the MCP server in its first sentence (323 of 350 characters), and why the first screen changed.

Worth a look

  • One string outside docs. The Description in src/IntuneGraphKit/IntuneGraphKit.psd1 is updated, because feat!: publish as IntuneGraphKit, with a tag-driven Gallery release #6 records that it carries the same text as the repository description. It is metadata only, with no runtime effect. Drop it if you would rather keep this PR to docs.
  • The repository description setting is not applied. The new text is recorded in docs/discoverability.md. Apply it with gh repo edit --description (or Settings → General) when you want it live.
  • No change to the MCP server, the launcher or the tools.

Claims checked

  • "Zero network calls, no CDN, no web fonts": the template has no @font-face, url(), fetch, <link> or external URLs, and an existing Pester test fails on an external URL in a generated report.
  • The skill spec's required inputs match Mcp.ps1: identity, group, and from + to.
  • ./build.ps1: PSScriptAnalyzer clean, 38/38 tests passing.

The MCP server is what flat-list assignment tools lack, yet it sat below the demo GIF.
It now follows the demo command, the tagline and description name it, the viewer's
zero-network-call design is stated as a feature, and docs/skill.md specifies the
Claude Code plugin - manifest, skill and the same six tools - as not yet shipped.
@juandresrodca
juandresrodca deleted the branch claude/project-continuation-494960 September 14, 2026 11:30
@juandresrodca
juandresrodca deleted the claude/mcp-first-readme branch September 14, 2026 11:31
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.

1 participant