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>

plugins/kyberforge/skills/marketplace-author/references/manifest-fields.md

@@ -2,6 +2,7 @@
 source_keys:
   - context7-websites-code-claude
   - claude-code-plugins-docs
+  - context7-github-en-copilot
   - github-cli-plugin-reference
   - github-plugins-marketplace
 ---
@@ -27,8 +28,9 @@ Both files must be kept identical at all times. Every operation that modifies on
 |---|---|---|---|
 | `name` | Yes | string | Marketplace name. Kebab-case, max 64 chars. Becomes the marketplace identifier used in `plugin install <name>@<marketplace>`. |
 | `owner` | Yes | object | `{ "name": string, "email"?: string }` — the marketplace maintainer. |
-| `description` | No | string | Human-readable description of the marketplace. Not in all schemas but accepted and displayed in the Discover tab. |
-| `version` | No | string | Marketplace-level version string. Used for catalog caching; bump when the plugin list changes significantly. |
+| `metadata` | No | object | `{ "description"?: string, "version"?: string, "pluginRoot"?: string }` — Copilot CLI canonical location for top-level description and version. Claude Code also accepts `description` and `version` directly at the top level; use `metadata` for dual-tool repos. |
+| `description` | No | string | Top-level description — Claude Code only. For dual-tool repos, prefer `metadata.description` instead. |
+| `version` | No | string | Top-level marketplace version — Claude Code only. For dual-tool repos, prefer `metadata.version` instead. |
 | `plugins` | Yes | array | Array of plugin entry objects. See Per-Entry Fields below. |
 
 ---
@@ -42,6 +44,19 @@ Both files must be kept identical at all times. Every operation that modifies on
 | `description` | No | string | Human-readable plugin description. Max 1024 chars (Copilot CLI schema). Displayed in browse output. |
 | `version` | No | string | Pinned version for catalog display. Optional for git-sourced plugins — Claude Code derives version from git tags. Required for npm source. Include when the user wants an explicit pinned version visible in the catalog. |
 | `author` | No | object | `{ "name": string, "email"?: string, "url"?: string }` — the plugin author. |
+| `homepage` | No | string | URL for the plugin homepage or docs site. |
+| `repository` | No | string | URL for the plugin source repository. |
+| `license` | No | string | SPDX license identifier (e.g. `"MIT"`, `"Apache-2.0"`). |
+| `keywords` | No | string[] | Search terms for discovery (feeds into Discover tab search index). |
+| `category` | No | string | Single category label for grouping in the Discover tab. |
+| `tags` | No | string[] | Additional classification tags. |
+| `agents` | No | string or string[] | Override the path(s) to agent definition files inside the plugin directory. Defaults to `agents/`. |
+| `skills` | No | string or string[] | Override the path(s) to skill directories inside the plugin. Defaults to `skills/`. |
+| `commands` | No | string or string[] | Override the path(s) to command definition files. |
+| `hooks` | No | string or object | Override the path(s) to hook definitions. |
+| `mcpServers` | No | string or object | Override MCP server configuration for the plugin. |
+| `lspServers` | No | string or object | Override LSP server configuration for the plugin. |
+| `strict` | No | boolean | Default `true`. Set to `false` for relaxed schema validation — allows extra or CC-specific fields without failing Copilot CLI validation. Use this for dual Claude Code / Copilot CLI plugins. |
 
 ---
 

plugins/kyberforge/skills/marketplace-author/references/sources.md

@@ -2,6 +2,7 @@
 source_keys:
   - context7-websites-code-claude
   - claude-code-plugins-docs
+  - context7-github-en-copilot
   - github-cli-plugin-reference
   - github-plugins-marketplace
   - github-plugins-finding-installing
@@ -25,6 +26,22 @@ source_keys:
 - **Contributing files:** SKILL.md, references/manifest-fields.md
 - **Status:** `extracted`
 
+## 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:** (none)
+- **Status:** `referenced`
+
+## 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 — including `metadata` object schema, per-entry optional fields, `strict` field behavior
+- **Contributing files:** SKILL.md, references/manifest-fields.md
+- **Status:** `extracted`
+
 ## github-cli-plugin-reference
 
 - **URL:** https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-plugin-reference
@@ -48,3 +65,83 @@ source_keys:
 - **Description:** User-facing guide to discovering and installing CLI plugins — marketplace browsing commands, install/update/uninstall workflow; informs REMOVE flow design (unlisting does not uninstall from existing users)
 - **Contributing files:** SKILL.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:** `referenced`
+
+## github-plugins-creating
+
+- **URL:** https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/plugins-creating
+- **Research doc:** plugins/kyberforge/docs/research/docs/github-copilot-plugins/sources.md
+- **Description:** How-to for creating Copilot CLI plugins — plugin structure, agent and skill authoring, hooks format, MCP config, development lifecycle
+- **Contributing files:** (none)
+- **Status:** `referenced`
+
+## github-sdk-custom-agents
+
+- **URL:** https://docs.github.com/en/copilot/how-tos/copilot-sdk/features/custom-agents
+- **Research doc:** plugins/kyberforge/docs/research/docs/github-copilot-plugins/sources.md
+- **Description:** SDK custom agent API — CustomAgentConfig fields in all five languages, session config, sub-agent lifecycle events, tool scoping, permission handling
+- **Contributing files:** (none)
+- **Status:** `referenced`
+
+## github-changelog-copilot-extensions-ga
+
+- **URL:** https://github.blog/changelog/2025-02-19-announcing-the-general-availability-of-github-copilot-extensions/
+- **Research doc:** plugins/kyberforge/docs/research/docs/github-copilot-plugins/sources.md
+- **Description:** Announcement of GitHub Copilot Extensions general availability (February 2025) — OIDC auth, all license tiers, VS Code/Visual Studio/JetBrains/GitHub.com support
+- **Contributing files:** (none)
+- **Status:** `referenced`
+
+## github-changelog-copilot-extensions-sunset
+
+- **URL:** https://github.blog/changelog/2025-09-24-deprecate-github-copilot-extensions-github-apps/
+- **Research doc:** plugins/kyberforge/docs/research/docs/github-copilot-plugins/sources.md
+- **Description:** Sunset notice for GitHub App-based Copilot Extensions — creation blocked Sep 24, 2025; full shutdown Nov 10, 2025; MCP servers recommended as replacement
+- **Contributing files:** (none)
+- **Status:** `referenced`
+
+## github-docs-copilot-extensions-skillsets
+
+- **URL:** https://docs.github.com/en/copilot/concepts/build-copilot-extensions/skillsets-for-copilot-extensions
+- **Research doc:** plugins/kyberforge/docs/research/docs/github-copilot-plugins/sources.md
+- **Description:** Concept doc for Copilot Extension skillsets — up to 5 skills per extension, Copilot handles routing/prompt crafting/response, contrast with agent extensions
+- **Contributing files:** (none)
+- **Status:** `referenced`
+
+## github-docs-copilot-extensions-building
+
+- **URL:** https://docs.github.com/en/copilot/building-copilot-extensions/setting-up-copilot-extensions
+- **Research doc:** plugins/kyberforge/docs/research/docs/github-copilot-plugins/sources.md
+- **Description:** How-to for setting up a Copilot Extension — GitHub App registration, Copilot Chat permission, Copilot Editor Context permission, backend URL configuration
+- **Contributing files:** (none)
+- **Status:** `referenced`
+
+## 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
+
+- **URL:** https://docs.github.com/en/apps/github-marketplace/creating-apps-for-github-marketplace/requirements-for-listing-an-app
+- **Research doc:** plugins/kyberforge/docs/research/docs/github-copilot-plugins/sources.md
+- **Description:** Requirements for listing a GitHub App on the GitHub Marketplace — verified publisher, capability description, UX stability, submission and review process
+- **Contributing files:** (none)
+- **Status:** `referenced`