Goal
Consolidate LightSpeed agents and skills in lightspeedwp/.github so they conform to current official standards and reach every repo in the organisation, then unblock #3434 and continue spec 014 on refactor/agents-restructure-consolidate.
Context: Asana ".Github Agent & Skills Consolidation Project" (1218728577142701), #3434 conflict proposal (#3434 (comment)), the consolidation guide and the external repo review Ash shared.
Decisions (verified against official sources, 2026-09-23)
| Concern |
Standard adopted |
Why |
Source |
| Org-wide agents (Copilot) |
Root agents/*.agent.md in the org .github repo |
Org-level custom agents are read from the root agents/ directory of the org .github repo. .github/agents/ would scope them to this repo only. |
GitHub: custom agents, org prep |
| Agent file format |
One *.agent.md with frontmatter name + description (plus optional tools, model) |
Copilot requires description; Claude Code subagents require name + description. One file satisfies both. |
Copilot config, Claude subagents |
| Agent working instructions |
AGENTS.md (root exists; optional nested per agent folder, nearest file wins) |
Open format stewarded by the Agentic AI Foundation (Linux Foundation); Claude Code and Copilot read it. Replaces the bespoke AGENT.md. |
agents.md |
| Skill format |
SKILL.md per the Agent Skills spec, frontmatter limited to the six spec fields |
Claude Code and Copilot both implement it; extra keys fail packaging. |
agentskills.io spec, Claude skills, Copilot skills |
| Org-wide skill distribution |
Root .claude-plugin/marketplace.json, one canonical copy referenced by path |
Copilot has no org-level skills. Claude Code and Copilot CLI both read .claude-plugin/marketplace.json. Plugins cannot reference files outside their root, so entries must point at canonical paths (source: "./" or git-subdir with strict: false), not copies. |
Claude marketplaces, plugins reference, Copilot CLI marketplace |
| Validation |
Native validator implementing the spec rules |
skills-ref states "for demonstration purposes only. It is not meant to be used in production." Use it only as an optional dev cross-check. |
skills-ref |
| Tests |
Allow both tests/ and __tests__/ |
Live .jest.config.cjs already matches both (Jest 30.5.2 installed). 17 agents use tests/, 10 use __tests__/. |
Jest testMatch |
Not adopted: moving everything to .github/agents and .github/skills. That would remove org-wide agent availability and still not distribute skills.
Work
Superseded
Older agent/skill consolidation epics and tasks are closed with a link here. The full list is in a comment on this issue.
Goal
Consolidate LightSpeed agents and skills in
lightspeedwp/.githubso they conform to current official standards and reach every repo in the organisation, then unblock #3434 and continue spec 014 onrefactor/agents-restructure-consolidate.Context: Asana ".Github Agent & Skills Consolidation Project" (1218728577142701), #3434 conflict proposal (#3434 (comment)), the consolidation guide and the external repo review Ash shared.
Decisions (verified against official sources, 2026-09-23)
agents/*.agent.mdin the org.githubrepoagents/directory of the org.githubrepo..github/agents/would scope them to this repo only.*.agent.mdwith frontmattername+description(plus optionaltools,model)description; Claude Code subagents requirename+description. One file satisfies both.AGENTS.md(root exists; optional nested per agent folder, nearest file wins)AGENT.md.SKILL.mdper the Agent Skills spec, frontmatter limited to the six spec fields.claude-plugin/marketplace.json, one canonical copy referenced by path.claude-plugin/marketplace.json. Plugins cannot reference files outside their root, so entries must point at canonical paths (source: "./"orgit-subdirwithstrict: false), not copies.skills-refstates "for demonstration purposes only. It is not meant to be used in production." Use it only as an optional dev cross-check.tests/and__tests__/.jest.config.cjsalready matches both (Jest 30.5.2 installed). 17 agents usetests/, 10 use__tests__/.Not adopted: moving everything to
.github/agentsand.github/skills. That would remove org-wide agent availability and still not distribute skills.Work
Superseded
Older agent/skill consolidation epics and tasks are closed with a link here. The full list is in a comment on this issue.