Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add AsyrafHussin/agent-skills --skill project-docsgit clone --depth 1 https://github.com/AsyrafHussin/agent-skillsWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/asyrafhussin/agent-skills/project-docs)<a href="https://agentmods.dev/skills/asyrafhussin/agent-skills/project-docs"><img src="https://agentmods.dev/badge/skills/asyrafhussin/agent-skills/project-docs.svg" alt="Measured on agentmods" height="20"></a>- Socket pass
- Snyk pass
- NVIDIA SkillSpector pass
What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00115 | $0.02637 |
| Opus 5 | $0.00057 | $0.01319 |
| Sonnet 5 | $0.00023 | $0.00527 |
| Haiku 4.5 | $0.00012 | $0.00264 |
Grade A, and why
project-docs scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 246 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Project Documentation
End-to-end documentation lifecycle for PHP/Laravel and Node/TypeScript/React projects. Contains 25 rules across 6 categories covering folder structure, naming conventions, essential files, content quality (including AI-slop detection), cleanup of accumulated junk, and lifecycle. Supports bootstrap mode (set up docs in a new project), audit mode (find what's missing, stale, bloated, or junk), and reference mode (conventions lookup).
Metadata
- Version: 1.0.0
- Scope: PHP / Laravel + Node / TypeScript / React projects
- Rule Count: 25 rules across 6 categories
- License: MIT
How to Use This Skill — Three Modes
Mode 1: Bootstrap (new project / missing docs)
When the user asks "set up docs", "what docs does this project need", or starts a new project — walk through the bootstrap steps:
- Detect project type (Laravel? React? Both?) —
composer.json,package.json,artisanbinary - Inventory existing docs — list every
.mdfile with its location and last-modified date - Identify gaps — compare against the Essential Files checklist; report what's missing
- Propose folder structure —
docs/with sub-folders (architecture/,adr/,guides/,runbooks/,archive/) based on project size - Offer to scaffold templates — README, CHANGELOG, LICENSE, CONTRIBUTING, SECURITY, ADR-0001 — generate with user approval, do not auto-create
- Suggest CI gates — markdown-lint, broken-link checker (lychee), CHANGELOG-on-PR enforcement
Mode 2: Audit (existing project cleanup)
When the user asks "audit docs", "clean up markdown", or "what should I delete" — produce a classified ledger.
For each .md file in the repo:
- KEEP — file is essential and current
- UPDATE — file is essential but stale (e.g., README contradicts current setup)
- ARCHIVE — superseded but historically useful — move to
docs/archive/<year>/ - DELETE — AI-generated plan files, empty stubs, duplicates, orphaned drafts
- MOVE — wrong location or wrong name (e.g.,
MyArchitectureNotes.mdat root →docs/architecture/overview.md)
What ships with it
30 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- AGENTS.md 94 KB
- metadata.json 3.3 KB
- README.md 2.0 KB
- rules/_sections.md 2.1 KB
- rules/_template.md 608 B
- rules/cleanup-ai-junk.md 5.1 KB
- rules/cleanup-duplicates.md 3.7 KB
- rules/cleanup-empty-stubs.md 3.7 KB
- rules/cleanup-orphans.md 3.9 KB
- rules/essential-changelog.md 3.9 KB
- rules/essential-contributing.md 3.0 KB
- rules/essential-license.md 3.4 KB
- rules/essential-readme.md 3.1 KB
- rules/essential-security.md 3.5 KB
- rules/lifecycle-adr-process.md 4.4 KB
- rules/lifecycle-archive.md 4.3 KB
- rules/lifecycle-changelog-discipline.md 4.0 KB
- rules/lifecycle-freshness.md 3.5 KB
- rules/naming-adr-files.md 3.5 KB
- rules/naming-anti-patterns.md 3.5 KB
- rules/naming-docs-files.md 3.0 KB
- rules/naming-root-files.md 3.2 KB
- rules/quality-ai-slop.md 5.5 KB
- rules/quality-code-blocks.md 3.8 KB
- rules/quality-conciseness.md 4.3 KB
- rules/quality-headings.md 3.8 KB
- rules/quality-links.md 4.3 KB
- rules/structure-docs-folder.md 3.3 KB
- rules/structure-root-files.md 3.3 KB
- rules/structure-subfolders.md 3.3 KB
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 8d ago First seen · 246 lines · 115 tokens per session scan A 1c405f53a623
project-docs is a skill published in the GitHub repository AsyrafHussin/agent-skills (72 stars, last pushed 11d ago), licensed MIT. It adds 115 tokens to every session and 2,637 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
code-humanizer
Use when AI-written code needs structural cleanup or when implementing a change under a guard against AI coding slop — duplicated reimplementations of existing helpers, try-import fallbacks, broad exception swallowing, speculative abstraction layers, v2 copies, dead "for future use" code, narrating comments …
slop-review
Read-only slop review of prose, documentation, reports, agent output, commit messages or PR descriptions. Use when someone asks what is wrong with a draft, asks for an editorial or quality review, asks whether text is padded, vague, puffed up, unsourced or hollow, or asks whether writing "sounds like AI". Produces a…
slop-verify
Verification pass for citations, links, package names and vendor residue. Use when someone asks whether the sources in a document are real, asks to check DOIs, ISBNs, arXiv IDs or URLs, asks whether a cited source actually supports the claim attached to it, asks to check that imported packages exist, or asks to strip…
anti-slop-brain
Scaffold and operate Anti-Slop Brain, a source-cited Obsidian brain for detection and repair of AI slop in prose, code, documentation, and agent output, grounded in corpus evidence rather than authorship detection. Use when the user says "anti-slop-brain", "Anti-Slop Brain", "create a detection and repair of AI slop…
slop-code
Slop review and repair for source code, tests, configuration, generated documentation, README files, commit messages and pull request descriptions. Use when someone asks to review generated or agent-written code for quality, asks whether a diff is padded or ceremonial, asks about hallucinated or slopsquatted imports…
anti-slop
Router for the anti-slop toolkit. Use when someone asks to review, clean, de-slop, humanize, or quality-check prose, documentation, code, commit messages, PR descriptions, or agent output, or asks whether some writing "sounds like AI". Also use for verifying citations, DOIs, links and imported package names, for…