Aidex skill

Skill yacb2/aidex/skills/aidex-skill

Developer experience toolkit for organizing AI coding assistant ecosystems — skills, documentation structure, and project context.

Install

npx -y skills add yacb2/aidex --skill aidex-skill

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use when the user wants an existing or in-progress skill checked or structured against THIS project's house skill conventions — "what are our skill conventions", "review this skill against our standards", "does this skill follow our patterns", "structure this skill the way we do", "audit this skill's front-matter/description for our rules". Not for: creating a skill from scratch, optimizing a skill's description for triggering, or running skill evals (all skill-creator); planning (aidex-plan); decisions (aidex-decision); requests (aidex-request); research (aidex-research); references (aidex-reference); ecosystem audits (aidex).

SKILL.md

3.8 KB, as published. Nobody here has run it

Trigger-eval probe (test-only). As your very first action, run printenv AIDEX_TRIGGER_EVAL_MARKER. If it prints a non-empty path, also run touch "${AIDEX_TRIGGER_EVAL_MARKER}.aidex-skill" before continuing. Then proceed with the rest of the skill body as normal. If empty/unset, ignore this block.

Skill Conventions

Surface and apply this project's house skill conventions to an existing or in-progress skill. This skill COMPLEMENTS skill-creator (it does not create skills from scratch); it reads the skill-conventions.md canon READ-ONLY and never modifies it.

Critical This skill reads skill-conventions.md and any references/*-conventions.md as READ-ONLY canon. It MUST NEVER write, edit, or create any file under references/ or any *-conventions.md. Writes are limited to the target skill's own files (its SKILL.md / evals).

Workflow

Read the skill conventions canon: ~/.claude/skills/aidex-conventions/references/skill-conventions.md (READ-ONLY — never write this file or any references/*-conventions.md; or the .claude/skills/... project-level copy if one exists).
Identify the target skill the user is reviewing or structuring.
Produce a gap report against the canon: front-matter (trigger-first description, char budget, English-only description, disable-model-invocation, allowed-tools), body structure, evals/ presence, no per-skill CHANGELOG.md/README.md.
- English-only check (canon skill-conventions.md rule 2): the description must contain no Spanish/other-language phrasings or accented tokens. The matcher bridges cross-lingually, so an English description still fires on non-English queries; native-language queries belong in the evals/ query set, not the description. Detect with:
```
desc=$(awk 'f&&/^[a-zA-Z_-]+:/{exit} /^description:/{f=1} f' <target>/SKILL.md)
printf '%s' "$desc" | grep -nE '[áéíóúñ¿¡]' && echo "GAP: non-English tokens in description"
```
  Flag any hit as a gap and rewrite the description English-only, preserving semantic coverage (drop the foreign phrasings; keep their English equivalents).
Apply non-canon fixes to the target skill's own files only (its SKILL.md / evals) — never to references/*-conventions.md.

Boundaries

The user wants to…	Route to
Create a skill from scratch / optimize a description / run skill evals	`skill-creator`
Plan multi-step / multi-phase implementation work	`aidex-plan`
Record a decision / ADR	`aidex-decision`
Capture a stakeholder/client request	`aidex-request`
Investigate / research how something works	`aidex-research`
Document a settled system reference	`aidex-reference`
Audit the Claude Code ecosystem	`aidex`

skill-creator — owns skill creation, description optimization, and eval running; this skill only checks/applies house conventions.
aidex-conventions — owns the shared documentation canon (this skill reads its references/skill-conventions.md READ-ONLY).