Defame1297/holocron
0
0
Fork 0
Code Issues 14 Pull Requests Actions Packages Projects Releases 3 Wiki Activity
Files
3a91126d3fcd3ac7ba3654ab931266153ea15f36
holocron/plugins/kyberforge/skills/plugin-author/references/sources.md
Defame1297 3a91126d3f fix(kyberforge): correct field classification and fill provenance gaps in plugin-author and marketplace-author 
## Why

The manifest-fields tables in both skills used imprecise labels ("CC-only",
"Copilot-only") that conflated two distinct reasons a field appears in only
one manifest: platform constraint (the other tool does not support the field
at all) versus repo convention (both tools support it, but the scaffold places
it in one manifest by design). This caused agents to treat convention
boundaries as hard platform constraints, producing unnecessary errors when
updating manifests for dual-tool repos.

Provenance was also incomplete: sources.md files were missing entries for
sources that had been consulted and were already contributing to SKILL.md
and manifest-fields.md content, making the evidence chain unverifiable.

## Implementation Notes

Field classification now uses three explicit categories — shared, platform
(one tool does not support the field), and convention (both tools support it;
scaffold places it in one manifest by design). The distinction matters because
convention fields may legitimately appear in the other manifest when there is
a deliberate reason; platform fields may not.

New gotchas added to plugin-author: agent files silently ignore hooks,
mcpServers, and permissionMode frontmatter; claude plugin tag --push requires
a clean working tree; --dry-run preview before tagging; --strict flag on
validate. New gotchas in marketplace-author: metadata object as Copilot CLI
canonical location for top-level fields; strict: false for dual-tool plugins;
sha takes precedence over ref for pinning; --strict flag on validate.

tests/ removed from plugin-author because new-plugin.sh has no branching
logic warranting a bats suite at this stage.

## Impact

Skill prompt changes only — no runtime code affected. Agents using these
skills will now correctly distinguish convention from constraint when deciding
which manifest to update for a given field.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-28 11:09:13 +00:00

8.2 KiB
Raw Blame History

source_keys
source_keys
context7-websites-code-claude
claude-code-plugins-docs
claude-code-subagents-docs
context7-github-en-copilot
github-cli-plugin-reference
github-plugins-creating
github-plugins-finding-installing
github-custom-agents-configuration
github-plugins-marketplace
github-sdk-custom-agents
github-changelog-copilot-extensions-ga
github-changelog-copilot-extensions-sunset
github-docs-copilot-extensions-skillsets
github-docs-copilot-extensions-building
vscode-chat-participant-api
github-marketplace-copilot-extensions
github-docs-marketplace-listing-requirements

Sources

context7-websites-code-claude

  • URL: context7:/websites/code_claude
  • Research doc: plugins/kyberforge/docs/research/docs/claude-code-plugins/sources.md
  • Description: Official Claude Code documentation site indexed by Context7 — plugin manifest schema, marketplace JSON format, claude plugin CLI commands, validation, tagging
  • Contributing files: SKILL.md, references/manifest-fields.md
  • Status: extracted

claude-code-plugins-docs

  • URL: https://code.claude.com/docs/en/plugins
  • Research doc: plugins/kyberforge/docs/research/docs/claude-code-plugins/sources.md
  • Description: Official Claude Code plugin authoring guide — plugin structure, CC manifest fields (displayName, author.url, version, outputStyles, experimental), marketplace submission, claude plugin tag
  • Contributing files: SKILL.md, references/manifest-fields.md
  • Status: extracted

github-cli-plugin-reference

github-plugins-creating

github-plugins-finding-installing

claude-code-subagents-docs

  • URL: https://code.claude.com/docs/en/sub-agents
  • Research doc: plugins/kyberforge/docs/research/docs/claude-code-plugins/sources.md
  • Description: Official Claude Code subagent reference — definition format, all frontmatter fields, scope priority, built-in agents, CLI flags, environment variables, known limitations
  • Contributing files: SKILL.md
  • Status: extracted

context7-github-en-copilot

  • URL: context7:/websites/github_en_copilot
  • Research doc: plugins/kyberforge/docs/research/docs/github-copilot-plugins/sources.md
  • Description: Official GitHub Copilot documentation indexed by Context7; covers CLI plugins, custom agents, SDK, and marketplace
  • Contributing files: SKILL.md, references/manifest-fields.md
  • Status: extracted

github-custom-agents-configuration

  • URL: https://docs.github.com/en/copilot/reference/custom-agents-configuration
  • Research doc: plugins/kyberforge/docs/research/docs/github-copilot-plugins/sources.md
  • Description: Reference for cloud and IDE custom agent definition format — frontmatter fields, tool aliases, MCP server config, secrets interpolation, scoping hierarchy
  • Contributing files: (none)
  • Status: extracted

github-plugins-marketplace

github-sdk-custom-agents

github-changelog-copilot-extensions-ga

github-changelog-copilot-extensions-sunset

github-docs-copilot-extensions-skillsets

github-docs-copilot-extensions-building

vscode-chat-participant-api

  • URL: https://code.visualstudio.com/api/extension-guides/ai/chat
  • Research doc: plugins/kyberforge/docs/research/docs/github-copilot-plugins/sources.md
  • Description: VS Code Chat Participant API — createChatParticipant(), package.json contributes.chatParticipants, Language Model API, @mention invocation in Copilot Chat
  • Contributing files: (none)
  • Status: referenced

github-marketplace-copilot-extensions

  • URL: https://github.com/marketplace?type=apps&copilot_app=true
  • Research doc: plugins/kyberforge/docs/research/docs/github-copilot-plugins/sources.md
  • Description: GitHub Marketplace listing for Copilot Extensions — browsable list of available extensions (historical; page remains live but product is sunset)
  • Contributing files: (none)
  • Status: referenced

github-docs-marketplace-listing-requirements

Reference in New Issue View Git Blame Copy Permalink