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/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<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="Reviewed on agentmods" width="80" 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.5 | $0.00046 | $0.01055 |
| Sonnet 5.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 1mo 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.
- 1mo 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 (93 stars, last pushed 1mo ago), licensed MIT. It adds 115 tokens to every session and 2,637 once invoked, about $0.0005 per session on Opus 5.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
patterns-of-enterprise-application-architecture
Apply Martin Fowler-inspired enterprise architecture rules when choosing layers, service layers, transaction scripts, domain models, repositories, mappers, or DTOs.
a-philosophy-of-software-design
Apply John Ousterhout-inspired software design rules when reducing complexity, designing module boundaries, or reviewing APIs and abstractions.
clean-architecture
Apply Robert C. Martin-inspired architecture rules when separating business policy from frameworks, databases, UI, or infrastructure details.
designing-data-intensive-applications
Apply Martin Kleppmann-inspired data-system rules when designing reliability, scalability, consistency, replication, transactions, streams, or schema evolution.
domain-driven-design-distilled
Apply Vaughn Vernon-inspired lightweight DDD rules when using bounded contexts, subdomains, context maps, and tactical modeling without excess ceremony.
domain-driven-design
Apply Eric Evans-inspired DDD rules when modeling a complex domain, defining bounded contexts, protecting ubiquitous language, or designing aggregates.