Cross-Platform Skill Conversion
TL;DR: Converts PMO-APEX skills from Claude Code format (SKILL.md) to equivalent formats for other AI coding assistants: Cursor (.cursorrules), GitHub Codex (AGENTS.md), Google Gemini (system instructions), and others. Preserves skill logic, evidence protocols, and methodology content across platforms.
Principio Rector
El conocimiento de PM no debe estar locked-in a una plataforma. Las skills MOAT contienen expertise de gestión de proyectos que es valiosa independientemente de la herramienta AI. La conversión cross-platform extiende el alcance sin diluir el contenido. El formato cambia; la inteligencia metodológica permanece.
Assumptions & Limits
- Assumes source SKILL.md files are at full MOAT compliance level [PLAN]
- Assumes target platform format specifications are documented and stable [SUPUESTO]
- Breaks when target platform has no equivalent to SKILL.md's allowed-tools constraint
- Not all sections translate 1:1; some platforms lack evidence tagging or quality gate concepts
- Converted skills require validation on target platform — conversion alone does not guarantee functionality
- Licensing constraints may apply to converted skills depending on organizational policy [STAKEHOLDER]
Usage
# Convert skills to Cursor format
/pm:cross-platform-convert $PROJECT --target="cursor" --skills="cost-estimation,budget-baseline"
# Batch convert all skills to Codex format
/pm:cross-platform-convert $PROJECT --target="codex" --skills="all"
# Generate platform compatibility matrix
/pm:cross-platform-convert $PROJECT --type=compatibility-matrix
Parameters:
| Parameter | Required | Description |
|---|
$PROJECT | Yes | Project or framework identifier |
--target | Yes | Target platform (cursor, codex, gemini, copilot) |
--skills | No | Skills to convert (comma-separated or "all") |
--type | No | convert, compatibility-matrix, validate |
Service Type Routing
{TIPO_PROYECTO}: All project types can benefit from cross-platform availability. Conversion priority based on target platform usage within the organization.
Before Converting
- Read the source SKILL.md files to understand content and structure to preserve
- Read target platform documentation for format specifications and constraints
- Glob
skills/cross-platform-convert/references/*.md for format mapping guides
- Grep for platform-specific limitations that may affect conversion fidelity
Entrada (Input Requirements)
- Source SKILL.md files to convert
- Target platform(s) and their format specifications
- Platform-specific limitations and capabilities
- Priority skills for conversion
- Target platform tool availability
Proceso (Protocol)
- Platform analysis — Understand target platform format requirements
- Skill selection — Choose skills to convert based on priority
- Format mapping — Map SKILL.md sections to target format structure
- Content adaptation — Adapt content for target platform constraints
- Tool mapping — Map allowed-tools to target platform equivalents
- Conversion execution — Generate converted skill files
- Validation — Test converted skills on target platform
- Documentation — Document platform-specific differences
- Batch processing — Convert remaining skills in batches
- Maintenance plan — Define sync protocol for skill updates
Edge Cases
- Target platform has no equivalent capability: Document capability gap. Implement workaround or note limitation in converted skill. Never silently drop functionality. [PLAN]
- Converted skill too large for target format: Split into multiple files per platform convention. Create index/router file linking sub-skills. [METRIC]
- Platform format specification changes: Version-pin conversions. Maintain conversion mapping per platform version. Reconvert when specification updates. [SUPUESTO]
- Licensing prevents conversion: Consult legal/compliance. Document licensing constraints. Convert only permitted skills. [STAKEHOLDER]
Example: Good vs Bad
Good Cross-Platform Conversion:
| Attribute | Value |
|---|
| Format mapping | Documented per section per platform |
| Content preservation | ≥90% of skill logic preserved |
| Tool mapping | Allowed-tools mapped to platform equivalents |
| Validation | Tested on target platform with sample execution |
| Documentation | Platform differences documented per skill |
| Sync protocol | Update procedure for skill changes |
Bad Cross-Platform Conversion:
Copy-pasting SKILL.md content into target format without format adaptation, tool mapping, or validation. Fails because each platform has different conventions — a verbatim copy may not be parseable, may ignore platform-specific features, and provides no maintenance path.
Validation Gate
Escalation Triggers
- Target platform lacks equivalent capabilities
- Conversion losing critical skill functionality
- Platform format specification changes
- Licensing constraints on converted skills
Additional Resources
| Resource | When to read | Location |
|---|
| Body of Knowledge | Before converting to understand platform ecosystems | references/body-of-knowledge.md |
| State of the Art | When evaluating new AI platform formats | references/state-of-the-art.md |
| Knowledge Graph | To understand skill dependencies for conversion order | references/knowledge-graph.mmd |
| Use Case Prompts | When scoping conversion requirements | prompts/use-case-prompts.md |
| Metaprompts | To generate format mapping templates | prompts/metaprompts.md |
| Sample Output | To calibrate expected conversion output | examples/sample-output.md |
Output Configuration
- Language: Spanish (Latin American, business register)
- Evidence: [PLAN], [SCHEDULE], [METRIC], [INFERENCIA], [SUPUESTO], [STAKEHOLDER]
- Branding: #2563EB royal blue, #F59E0B amber (NEVER green), #0F172A dark
Sub-Agents
Compatibility Validator
Compatibility Validator Agent
Core Responsibility
Validates converted skills against target platform requirements. This agent operates autonomously, applying systematic analysis and producing structured outputs.
Process
- Gather Inputs. Collect all relevant data, documents, and stakeholder inputs needed for analysis.
- Analyze Context. Assess the project context, methodology, phase, and constraints.
- Apply Framework. Apply the appropriate analytical framework or model.
- Generate Findings. Produce detailed findings with evidence tags and quantified impacts.
- Validate Results. Cross-check findings against related artifacts for consistency.
- Formulate Recommendations. Transform findings into actionable recommendations with owners and timelines.
- Deliver Output. Produce the final structured output with executive summary, analysis, and action items.
Output Format
- Analysis Report — Structured findings with evidence tags and severity ratings.
- Recommendation Register — Actionable items with owners, deadlines, and success criteria.
- Executive Summary — 3-5 bullet point summary for stakeholder communication.
Format Transformer
Format Transformer Agent
Core Responsibility
Transforms skill files between plugin framework formats. This agent operates autonomously, applying systematic analysis and producing structured outputs.
Process
- Gather Inputs. Collect all relevant data, documents, and stakeholder inputs needed for analysis.
- Analyze Context. Assess the project context, methodology, phase, and constraints.
- Apply Framework. Apply the appropriate analytical framework or model.
- Generate Findings. Produce detailed findings with evidence tags and quantified impacts.
- Validate Results. Cross-check findings against related artifacts for consistency.
- Formulate Recommendations. Transform findings into actionable recommendations with owners and timelines.
- Deliver Output. Produce the final structured output with executive summary, analysis, and action items.
Output Format
- Analysis Report — Structured findings with evidence tags and severity ratings.
- Recommendation Register — Actionable items with owners, deadlines, and success criteria.
- Executive Summary — 3-5 bullet point summary for stakeholder communication.
Migration Plan Builder
Migration Plan Builder Agent
Core Responsibility
Builds migration plan for cross-platform skill conversion. This agent operates autonomously, applying systematic analysis and producing structured outputs.
Process
- Gather Inputs. Collect all relevant data, documents, and stakeholder inputs needed for analysis.
- Analyze Context. Assess the project context, methodology, phase, and constraints.
- Apply Framework. Apply the appropriate analytical framework or model.
- Generate Findings. Produce detailed findings with evidence tags and quantified impacts.
- Validate Results. Cross-check findings against related artifacts for consistency.
- Formulate Recommendations. Transform findings into actionable recommendations with owners and timelines.
- Deliver Output. Produce the final structured output with executive summary, analysis, and action items.
Output Format
- Analysis Report — Structured findings with evidence tags and severity ratings.
- Recommendation Register — Actionable items with owners, deadlines, and success criteria.
- Executive Summary — 3-5 bullet point summary for stakeholder communication.
Skill Format Analyzer
Skill Format Analyzer Agent
Core Responsibility
Analyzes source skill format for conversion compatibility. This agent operates autonomously, applying systematic analysis and producing structured outputs.
Process
- Gather Inputs. Collect all relevant data, documents, and stakeholder inputs needed for analysis.
- Analyze Context. Assess the project context, methodology, phase, and constraints.
- Apply Framework. Apply the appropriate analytical framework or model.
- Generate Findings. Produce detailed findings with evidence tags and quantified impacts.
- Validate Results. Cross-check findings against related artifacts for consistency.
- Formulate Recommendations. Transform findings into actionable recommendations with owners and timelines.
- Deliver Output. Produce the final structured output with executive summary, analysis, and action items.
Output Format
- Analysis Report — Structured findings with evidence tags and severity ratings.
- Recommendation Register — Actionable items with owners, deadlines, and success criteria.
- Executive Summary — 3-5 bullet point summary for stakeholder communication.