What is the Broken References skill?
Broken References is a coding skill by alibaba for Claude Code, Cursor, Codex and other AI coding agents. A skill whose body cites attachment paths that do not exist.
See references/missing.md for the full guide and assets/gone.png for the architecture diagram.
- Author
- alibaba
- Pack
- alibaba/skill-up (30 skills)
- Category
- Coding, #1645 of 1777
- Alyn Score
- 48 / 99
- Files
- 1
- License
- Apache-2.0
- Last updated
- 2 days ago
- Works with
- Claude Code, Claude, Cursor, Codex, Gemini CLI, Copilot
Broken References compared to similar skills
| Skill | Alyn Score | GitHub stars | Updated |
|---|---|---|---|
| Broken References · alibaba | 48 | 1.5k | 2 days ago |
| PR · Matt Pocock | 94 | 328k | 3 days ago |
| Performance Optimization · Addy Osmani | 91 | 119k | 2 days ago |
| Simplify Codebase · tt-a1i | 88 | 98k | 2 days ago |
Install Broken References
Pick your agent. Every command is ready to paste.
npx alyn-cli add broken-referencesDetects your agents (Claude Code, Cursor, Codex and 70+ more) and installs to the right folder. Add -g to install globally.
npx skills add alibaba/skill-up --skill broken-referencesOr use the open skills CLI directly.
01
Install it
Run the command above, or upload the folder in Claude.
02
Ask naturally
Describe the task. Your agent loads broken-references when the request matches its description.
03
Name it if needed
If it does not trigger, say “use the broken-references skill”. In Codex, type $broken-references.
Broken References
See references/missing.md for the full guide and assets/gone.png for the
architecture diagram.
Tips for Broken References
- • Start a fresh session after installing so your agent picks up the new skill.
- • It is part of a pack with 30 skills. Install only the ones you need with --skill to keep triggers precise.
- • If two skills overlap, mention the one you want by name.
Questions about Broken References
What does the Broken References skill do?
A skill whose body cites attachment paths that do not exist.
How do I install Broken References?
Run "npx alyn-cli add broken-references" in your project. The Alyn CLI installs it for Claude Code, Cursor, Codex and 70+ other agents. In Claude on the web, upload the skill folder as a ZIP under Customize > Skills.
Does Broken References work in Cursor and Codex?
Yes. Broken References uses the open SKILL.md format, so it works in Claude Code, Claude, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot and other agents that support agent skills.
What is a good alternative to Broken References?
PR by Matt Pocock is the highest-ranked similar skill from another creator, with an Alyn Score of 94 compared to 48 for Broken References.
Is Broken References free?
Broken References is open source on GitHub under the Apache-2.0 license. It is free to install; check the license before commercial use.
Who made Broken References?
Broken References is published by alibaba in the alibaba/skill-up repository, together with 29 other skills.




