Is documentation-and-adrs 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.

Scan reports · addyosmani/agent-skills

documentation-and-adrs: scan report

Records decisions and documentation. Use when you need to document an architecture decision (ADR) or the reasoning behind a design choice, when changing public APIs, shipping features, or when you need to record… An automated scan of this public skill from addyosmani/agent-skills: security, token cost, spec and clarity, with every finding and its fix.

Verdict

No known risky patterns found

Nothing in the skill matched the scanner's security rules: no instruction overrides, hidden characters, remote code or credential access.

documentation-and-adrsScan 96/100Grade A

addyosmani/agent-skills/skills/documentation-and-adrs at aeac41d

Spec 25 · Efficiency 25 · Clarity 21 · Security 25 (each out of 25)

Always loaded 79 tokens · on trigger 2,634 · on demand 0

clarity/unfinished warn · SKILL.md:131Unfinished marker "TODO".

Source

Fact	Value
Repository	addyosmani/agent-skills
Skill folder	skills/documentation-and-adrs
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.

[![ProSkills scan 96/100](https://proskills.dev/badge?score=96)](https://proskills.dev/reports/addyosmani-documentation-and-adrs)

Scanned alternatives on ProSkills

Skills in the ProSkills catalog that cover similar ground. Every one passes the same scanner before it ships.

ADR Writer$7Scan 100/1003 rules · Grill MeDecisions written down properly.Loads when a technical decision is made.

More from addyosmani/agent-skills

Skill	Scan	Grade
api-and-interface-design	97/100	A
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
doubt-driven-development	93/100	A
frontend-ui-engineering	92/100	A
git-workflow-and-versioning	89/100	B

Questions

Is documentation-and-adrs 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

Scan your own skill

Paste a SKILL.md or drop a folder. It is scored in your browser and nothing is uploaded.

Open the Skill Scanner

Want a skill that already passes? Start with a free one.