Agent skill · affaan-m
skill-host-compat
Lint ECC skills for Codex/Cursor-safe frontmatter and Claude-only substitutions before a skill PR.
What it needs
About 2k tokens when loaded.
What this skill does
Skill Host Compatibility Run the same host-compat gate CI uses on skills/ before opening a skill PR. The check is for Codex and Cursor copies, not Claude-only runtime quality. When to Activate Adding or editing a skill under skills/ Copying a skill into .agents/skills/ or .cursor/skills/ A review asks whether a skill is safe to install into Codex or Cursor CI reports validate-skill-host-compat.js findings Core Concepts Canonical skills live in skills/. Codex loads .agents/skills/. Cursor loads a smaller .cursor/skills/ subset. CONTRIBUTING documents that sync as manual. validate-skills.js only checks that SKILL.md exists and that name / description are usable YAML. tests/ci/codex-skill-surface.test.js only sees .agents/skills/. This script is the cross-tree gate: 1. Claude-only substitutions in executable bash / sh / zsh fences in Codex/Cursor projections (${CLAUDESESSIONID}, ${CLAUDESKILLDIR}, ${CLAUDEPLUGINROOT}, ${CLAUDEPROJECTDIR}, $ARGUMENTS) fail. Codex leaves those tokens as literal text. In a Codex copy, rewrite ${CLAUDEPROJECTDIR} to $(pwd) or an explicit path. 2. A Codex copy may only use name, description, metadata, license, and allowed-tools. origin: ECC may stay on the canonical skills/ copy and must be stripped on the Codex copy. 3. A skill listed in agents/openai.yaml that has a skills/ directory must have .agents/skills/<name>/. Cursor copies are optional; when present, name: must match the directory. 4. CONTRIBUTING checklist items (When to Activate, Anti-Patterns, name matches directory, 500/800 line caps) warn. They fail only with --strict-checklist. validate-skills.js frontmatter WARN default is unchanged (#1663). Code Examples From the repo root: Print counts without failing: Promote checklist warnings: Slash command: Anti-Patterns Codex and Cursor projections must resolve Claude-only substitutions in executable blocks. Canonical Claude-scoped examples remain valid. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills affaan-m/skill-host-compat--e09eb1