Skip to content

feat: make skills platform-agnostic across coding agents#330

Merged
tmchow merged 8 commits intomainfrom
feat/report-bug-tool-agnostic
Mar 22, 2026
Merged

feat: make skills platform-agnostic across coding agents#330
tmchow merged 8 commits intomainfrom
feat/report-bug-tool-agnostic

Conversation

@tmchow
Copy link
Collaborator

@tmchow tmchow commented Mar 22, 2026

Summary

  • AGENTS.md: Add cross-platform task tracking and script path reference checklist sections to the skill compliance checklist
  • report-bug-ce: Rename from report-bug (avoid plugin name collisions), replace Claude Code-specific env detection with multi-platform guidance, fix nested code fence bug
  • heal-skill: Remove — overlaps with existing skill-creator/skill-development, uses non-standard XML, violates tool selection checklist
  • resolve-pr-parallel / resolve-todo-parallel: Replace ${CLAUDE_PLUGIN_ROOT} with relative paths, replace TodoWrite with TaskCreate/update_plan, use fully-qualified agent names, add sequential fallback
  • setup: Replace Claude Code-specific structured question format with plain numbered lists, list platform equivalents for question tools
  • test-browser: Remove XML tags, make Chrome MCP warning platform-aware, generalize port detection, list platform equivalents for user interaction
  • test-xcode: Replace mcp__xcodebuildmcp__* syntax with semantic tool descriptions, add standard install instructions (Homebrew + npx), remove XML tags and emojis, fix /xcode-test -> /test-xcode name mismatch
  • README: Remove heal-skill, rename report-bug entry, fix xcode-test skill name

tmchow added 8 commits March 21, 2026 17:23
…cklist sections

New skill compliance checklist sections:
- Cross-Platform Task Tracking: documents TaskCreate/TaskUpdate/TaskList
  (Claude Code), update_plan (Codex), flags TodoWrite as legacy
- Script Path References: codifies relative paths over
  ${CLAUDE_PLUGIN_ROOT}, requires companion markdown links
- Rename skill to report-bug-ce to avoid name collisions with other plugins
- Replace Claude Code-specific env detection with multi-platform guidance
- Add Agent Platform/Agent Version fields to bug report template
- List platform equivalents for user interaction tools
- Fix nested code fence that broke markdown rendering
heal-skill overlaps with existing skill-creator and skill-development
skills, uses non-standard XML tags, violates the tool selection
checklist, and wraps behavior agents handle naturally.
- Replace ${CLAUDE_PLUGIN_ROOT} with relative script paths
- Replace TodoWrite with TaskCreate (Claude Code) / update_plan (Codex)
- Use fully-qualified agent name for pr-comment-resolver
- Add sequential fallback for platforms without parallel dispatch
- Use semantic wording for skill cross-references
- List platform equivalents for question tools (AskUserQuestion,
  request_user_input, ask_user) with plain-text fallback
- Replace Claude Code-specific structured YAML question format with
  numbered lists that work on any platform
- Keep efficient test -f stack detection script
- Remove all non-standard XML tags
- List platform equivalents for user interaction tools
- Make Chrome MCP warning platform-aware instead of Claude Code-specific
- Generalize port detection to check AGENTS.md as primary instruction file
- Remove duplicate agent-browser vs Chrome MCP warnings from CLI reference
- Replace mcp__xcodebuildmcp__* Claude Code syntax with semantic tool
  descriptions (e.g. "Call XcodeBuildMCP's list_simulators tool")
- Add standard install instructions (Homebrew + npx) for XcodeBuildMCP
- List platform equivalents for user interaction tools
- Remove non-standard XML tags and emojis from output template
- Fix incorrect agent reference in ce:review integration section
- Fix skill name mismatch (/xcode-test -> /test-xcode) in examples
- Remove heal-skill entry (skill deleted)
- Rename /report-bug to /report-bug-ce
- Fix /xcode-test to /test-xcode to match actual skill name
Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 3c35ebec4d

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@tmchow tmchow merged commit 52df90a into main Mar 22, 2026
2 checks passed
@github-actions github-actions bot mentioned this pull request Mar 22, 2026
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