Skip to content

Add skill-format-migrator agent + Copilot authoring reference#2072

Closed
starlightretailceo wants to merge 2 commits into
github:stagedfrom
starlightretailceo:contrib/skill-format-migrator
Closed

Add skill-format-migrator agent + Copilot authoring reference#2072
starlightretailceo wants to merge 2 commits into
github:stagedfrom
starlightretailceo:contrib/skill-format-migrator

Conversation

@starlightretailceo

Copy link
Copy Markdown

Summary

  • Agent (skill-format-migrator.agent.md): Converts Claude Agent Skills and OpenAI Codex skill definitions into Copilot .agent.md / SKILL.md format. Includes decision flow, platform idiom translation, and validation checklist.
  • Skill (skills/copilot-skill-authoring/SKILL.md): Authoring reference — frontmatter contracts for both formats, trigger-description patterns, 17-row concept mapping table (Claude/Codex → Copilot), and file organization conventions.

Motivation

The repo has many "build MCP server in language X" generators but nothing for porting existing agent/skill assets into Copilot format. This meta-contribution lowers the barrier for the community to migrate work from other ecosystems (Claude, Codex, Cursor) into awesome-copilot.

Test plan

  • Feed a real Claude SKILL.md through the agent and verify output matches repo conventions
  • Feed a Codex skill and verify .agent.md output has valid frontmatter
  • Cross-reference concept mapping table against CONTRIBUTING.md

🤖 Generated with Claude Code

@github-actions github-actions Bot added agent PR touches agents new-submission PR adds at least one new contribution skills PR touches skills targets-main PR targets main instead of staged labels Jun 21, 2026

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ This PR targets main, but PRs should target staged.

The main branch is auto-published from staged and should not receive direct PRs.
Please close this PR and re-open it against the staged branch.

You can change the base branch using the Edit button at the top of this PR,
or run: gh pr edit 2072 --base staged

@starlightretailceo starlightretailceo changed the base branch from main to staged June 21, 2026 01:36
github-actions[bot]
github-actions Bot previously approved these changes Jun 21, 2026

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

✅ Base branch is now set correctly.

Removing the prior block because this PR no longer targets main.

@github-actions github-actions Bot added branched-main PR appears to include plugin files materialized from main external-plugin PR updates plugins/external.json ready-for-review Submission passed intake validation and is ready for maintainer review and removed skills PR touches skills targets-main PR targets main instead of staged agent PR touches agents new-submission PR adds at least one new contribution labels Jun 21, 2026
@github-actions

Copy link
Copy Markdown
Contributor

✅ External plugin PR checks passed

  • Changed entries detected: 0
  • Workflow state label: ready-for-review

Per-plugin quality summary

Plugin skill-validator install smoke test overall source tree
none not_run not_run not_run n/a

No changed external plugin entries were detected in this PR.

Agent: converts Claude/Codex skill definitions into Copilot .agent.md/SKILL.md format.
Skill: authoring reference with frontmatter contracts, trigger patterns, and concept mapping table.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@starlightretailceo starlightretailceo force-pushed the contrib/skill-format-migrator branch from 2b77cd7 to 81dd4b5 Compare June 21, 2026 02:06
@github-actions github-actions Bot added agent PR touches agents new-submission PR adds at least one new contribution skills PR touches skills and removed branched-main PR appears to include plugin files materialized from main external-plugin PR updates plugins/external.json labels Jun 21, 2026
@github-actions

github-actions Bot commented Jun 21, 2026

Copy link
Copy Markdown
Contributor

🔒 PR Risk Scan Results

Scanned 4 changed file(s).

Severity Count
🔴 High 0
🟠 Medium 1
ℹ️ Info 0
Severity Rule File Line Match
🟠 package-exec-command docs/README.skills.md 31 | [acreadiness-assess](../skills/acreadiness-assess/SKILL.md)&lt;br /&gt;`gh skills install github/awesome-copilot acreadiness-assess` | Run the AgentRC readiness assessment on the curre

This is an automated soft-gate report. Findings indicate review targets and do not block merge by themselves.

@github-actions

github-actions Bot commented Jun 21, 2026

Copy link
Copy Markdown
Contributor

🔍 Skill Validator Results

✅ All checks passed

Scope Checked
Skills 1
Agents 1
Total 2
Severity Count
❌ Errors 0
⚠️ Warnings 0
ℹ️ Advisories 0

Summary

Level Finding
ℹ️ Found 1 skill(s)
ℹ️ [copilot-skill-authoring] 📊 copilot-skill-authoring: 1,991 BPE tokens [chars/4: 2,384] (detailed ✓), 18 sections, 5 code blocks
ℹ️ Found 1 agent(s)
ℹ️ Validated 1 agent(s)
ℹ️ ✅ All checks passed (1 skill(s), 1 agent(s))
Full validator output
Found 1 skill(s)
[copilot-skill-authoring] 📊 copilot-skill-authoring: 1,991 BPE tokens [chars/4: 2,384] (detailed ✓), 18 sections, 5 code blocks
Found 1 agent(s)
Validated 1 agent(s)
✅ All checks passed (1 skill(s), 1 agent(s))

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@starlightretailceo starlightretailceo force-pushed the contrib/skill-format-migrator branch from e865ced to 340a515 Compare June 21, 2026 02:16
@aaronpowell

Copy link
Copy Markdown
Contributor

The items in this PR are incorrect in many instances. Copilot will load files from the folder structures used by Claude where they are applicable, and does mapping when front matter has inconsistencies. There is no need to create bespoke implementations.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

agent PR touches agents new-submission PR adds at least one new contribution ready-for-review Submission passed intake validation and is ready for maintainer review skills PR touches skills

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants