Scan reports · addyosmani/agent-skills
api-and-interface-design: scan report
Guides stable API and interface design. Use when designing APIs, module boundaries, or any public interface. Use when creating REST or GraphQL endpoints, defining type contracts between modules, or establishing… An automated scan of this public skill from addyosmani/agent-skills: security, token cost, spec and clarity, with every finding and its fix.
Verdict
addyosmani/agent-skills/skills/api-and-interface-design at aeac41d
Spec 25 · Efficiency 22 · Clarity 25 · Security 25 (each out of 25)
Always loaded 69 tokens · on trigger 3,626 · on demand 0
eff/no-disclosureinfo · SKILL.md~3626 tokens in one file. Long tables, examples or catalogues belong in reference files.
Source
| Fact | Value |
|---|---|
| Repository | addyosmani/agent-skills |
| Skill folder | skills/api-and-interface-design |
| Stars | 107,328 |
| License | MIT |
| Commit scanned | aeac41d |
| Scanned | 2026-10-16 |
| Files | 1 |
ProSkills doesn't host or redistribute this skill. Get it from its repository, and check the license before reusing it. Something wrong here? Open an issue for a rescan or removal.
Badge for the README
If you maintain this skill, this badge shows its score and links to this report. Fix findings and the score moves with the next scan.
[](https://proskills.dev/reports/addyosmani-api-and-interface-design)
Scanned alternatives on ProSkills
Skills in the ProSkills catalog that cover similar ground. Every one passes the same scanner before it ships.
- Taste CoreFreeScan 100/1004 rules · Frontend TasteSpacing, type scale, one accent.Loads when the user builds or restyles any UI.
- Type Pairing$7Scan 100/1003 rules · Frontend TasteFont pairs that never look default.Loads when the user picks fonts.
- Admin Panel$12Scan 100/1003 rules · Mini-appsA clean back office for any API.Loads when the user needs an admin interface.
More from addyosmani/agent-skills
| Skill | Scan | Grade |
|---|---|---|
| browser-testing-with-devtools | 91/100 | A |
| ci-cd-and-automation | 100/100 | A |
| code-review-and-quality | 84/100 | B |
| code-simplification | 97/100 | A |
| constraint-driven-development | 80/100 | B |
| context-engineering | 97/100 | A |
| debugging-and-error-recovery | 100/100 | A |
| deprecation-and-migration | 97/100 | A |
| documentation-and-adrs | 96/100 | A |
| doubt-driven-development | 93/100 | A |
| frontend-ui-engineering | 92/100 | A |
| git-workflow-and-versioning | 89/100 | B |
Questions
- Is api-and-interface-design safe to install?
- No known risky patterns found. The scan covers prompt injection, hidden Unicode, remote code execution and credential access in every text file of the skill. It cannot judge intent, so read any flagged line in context before installing.
- How was this score calculated?
- Four checks of 25 points each: spec, efficiency, clarity and security. Findings take points off the check they belong to, and any critical finding caps the grade at F. The same scanner runs in your browser at proskills.dev/scan.
- Is this report current?
- It was made from commit aeac41d on 2026-10-16. If the skill has changed since, paste the new version into the scanner for a fresh score.
- I wrote this skill. Can I fix the score or have the page removed?
- Fix the findings and push. The reports are rebuilt from GitHub on a schedule, so the next run picks the change up. To have the page removed, open an issue on the ProSkills GitHub repo.
Keep reading
Paste a SKILL.md or drop a folder. It is scored in your browser and nothing is uploaded.
Want a skill that already passes? Start with a free one.