docs-portal
Skill9 starsChanged 15 days agoMITView on GitHub
Rebuild and verify the AgentLane website documentation portal after docs-sync or edits to root documentation, navigation, or portal rendering.
In this repository5 other files it gives its agents.
- AGENTS.mdAGENTS.md
- code-change-verificationSkill
- docs-syncSkill
- releaseSkill
- vhsSkill
The file
We split this skill into the rules it gives an agent
11 rules. About 0 are common, 5 are distinctive, and 6 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈5
Distinctive · estimate
This author's own choices. Worth a look.
6
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 8
Keep public Markdown in root docs/.
- Very specific: line 13
If you change documentation prose, use dev-docs from the session's skill catalog.
- Very specific: line 17
Use Node.js 24 and pnpm 10.29.3.
- Very specific: line 19
Run make -C website check.
- Distinctive: line 30
Use relative Markdown links in source files so they also work on GitHub.
- Very specific: line 41
Keep docs/README.md as the documentation home.
- Distinctive: line 43
Use a nested folder's README title and route for its group.
- Distinctive: line 47
Every public page must appear once in navigation and remain in search.
- Distinctive: line 48
Use concise Markdown page titles.
- Very specific: line 52
Use docs/README.md to order siblings.
- Distinctive: line 59
Check the generated structure against every public source path.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Documentation portal
Keep public Markdown in root docs/. Astro reads those files directly.
docs/plans/ is internal and must stay out of routes, navigation, and search.
Workflow
- If you change documentation prose, use
dev-docsfrom the session's skill catalog. Apply its review checklist to the changed pages. Reuse a completed review from docs-sync when the text has not changed. If the skill is missing, report that limitation and do not claim a completed style review. - Use Node.js 24 and pnpm 10.29.3. From the repository root, install the website
dependencies with
make -C website installif needed. - Run
make -C website check. This checks formatting and types, builds the website from root documentation, and tests the generated routes and links. - Fix failures within the changed scope and repeat the check. For layout or
interaction changes, use
make -C website devto check a changed page on desktop and mobile. Check navigation, search, code blocks, and both themes. - Report the source pages, check results, and unresolved failures. Generated
files stay in ignored
website/dist/; do not commit them.
The build creates /docs/ from docs/README.md. Other Markdown files retain
their relative path without .md; nested README files use directory routes.
The build derives navigation and search from the same public collection.
Use relative Markdown links in source files so they also work on GitHub.
The website workflow runs on public docs changes. Deployment uses the website's normal release process. A local rebuild does not publish the site.
Navigation contract
Apply these rules to all public documentation on every rebuild:
- Discover every public Markdown file under
docs/recursively. Folder paths define section membership and nesting depth. Excludedocs/plans/. - Keep
docs/README.mdas the documentation home. Use each top-level folder as a section, with its README page first if present. - Use a nested folder's README title and route for its group. Show that page once. A folder without a README has a label without a link; do not create a page or route for it.
- Derive the sidebar, breadcrumbs, and previous/next links from the same tree. Every public page must appear once in navigation and remain in search.
- Use concise Markdown page titles. Omit parent names that the hierarchy already supplies. Group tool references under Harness > Tools and use each exact tool name as its title, without a "Tool" suffix. Apply title changes in source Markdown so pages, navigation, and search agree.
- Use
docs/README.mdto order siblings. Top-level label and order overrides can remain, but must not select pages or limit nesting. Do not add manual hierarchy lists for specific sections or providers. - Include added folders and pages automatically, even when the documentation index does not list them. When moving sources, repair incoming links because folder paths also determine routes.
Check the generated structure against every public source path. Verify folder ancestry, README placement, page coverage, and links across the documentation.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

