Skip to content
cccskills
FreePublished on GitHub

nav-audit

Audit site navigation — find dead-end features, missing backlinks, and poor discoverability. Produces an improvement list, no code changes.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md3.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Navigation & Discoverability Audit

Audit every feature to verify it's reachable through obvious UI paths. Produces an improvement list — does NOT make changes.

Severity Levels

SeverityMeaning
SHOWSTOPPERFeature only reachable by typing the URL directly.
POORReachable but path is non-obvious, buried, or link text is unclear.
MISSING BACKLINKNo link from a listing/parent page to its detail/action page.
SUGGESTIONWorks but could be improved (shortcut, breadcrumb, contextual button).

Authorization Awareness

Audit each route for the role that should use it. Hidden admin features are correct, not bugs.

RoleSees
UnauthenticatedPublic pages (home, login)
Authenticated (no approval)Membership gate (profile setup, consent)
Active memberFull member experience
LeadTeam admin for their teams
BoardAdmin panel subset, member approval
AdminFull admin panel, configuration

Process

Step 1: Build route inventory

Scan for all controller actions and Razor pages — URL, HTTP method, required auth, purpose.

Sources:

  • src/Humans.Web/Controllers/*.cs — [Route], [HttpGet], [HttpPost], [Authorize] attributes
  • src/Humans.Web/Pages/**/*.cshtml — Razor pages
  • src/Humans.Web/Views/**/*.cshtml — MVC views

Step 2: Build navigation map

For each route, find inbound links in:

  • Layouts/nav: _Layout.cshtml, _AdminLayout.cshtml, sidebar partials
  • Page links: <a>, asp-action, asp-controller, asp-page tag helpers
  • Contextual actions: edit/delete/view buttons in list items
  • Dashboard widgets: admin dashboard cards

Step 3: Analyze gaps

For each route determine:

  1. Is it linked from its natural parent? (detail ← list, edit ← view, admin sub-page ← admin nav)
  2. Is it reachable within 1-2 clicks for the target role?
  3. Zero inbound links → SHOWSTOPPER; linked only from non-obvious places → POOR

Step 4: Check action flows

Verify multi-step workflows have clear navigation: form submit lands somewhere useful, list action buttons are visible, success pages link back to the relevant list.

Step 5: Produce report

Output sections in order: Route Inventory (totals by role), then four issue tables (SHOWSTOPPERS / POOR Discoverability / MISSING BACKLINKS / SUGGESTIONS), each with columns: Route | Feature | Problem/Current Path | Suggested Fix. Close with a counts summary.

Step 6: Wait for discussion

Present the report. Do NOT make code changes until the user approves specific items.

Scope Control

If $ARGUMENTS specifies a section, audit only that area:

  • all (default) — entire site
  • teams — team browsing, joining, team admin
  • admin — admin panel navigation
  • profile — profile, email, privacy, contact fields
  • consent — legal documents and consent flow
  • governance — asociado application flow

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Check an externally created PR for coding rule violations against memory/INDEX.md atoms and docs/architecture/code-review-rules.md.

The English summary is being prepared. Showing the original description.

nobodies-collective/Humans4Updated Oct 22, 2026

Two-phase memory hygiene. Phase 1: scan external Claude Code memory (~/.claude/projects/<slug>/memory/) for durable rules to migrate into the repo and entries already duplicated by repo atoms. Phase 2: audit in-repo memory/, CLAUDE.md, docs/architecture/, and docs/sections/ for dead links, duplication, drift, and bloat.

The English summary is being prepared. Showing the original description.

nobodies-collective/Humans4Updated Oct 22, 2026

Review, repair and steward the nightly Codex debt-sweep PR (branch codex/daily-debt/<date>). Judges every commit GOOD / REPAIR / REVERT, triages the bot review findings through /fix, lands one round-1 commit, files follow-up issues, then stewards the PR itself with a 3-round ceiling. Run by the 08:00 UTC cloud routine; also '/debt-review', '/debt-review 1789'.

The English summary is being prepared. Showing the original description.

nobodies-collective/Humans4Updated Oct 22, 2026

Autonomous themed tech-debt cleanup. Reads docs/architecture/debt-ledger.yml, rotates to the least-recently-served debt theme, works it for a time budget (default 2h) or until drained, opens one PR, and asks judgment questions inline at the end. Use for daily debt burndown without Peter pointing at a target: grandfathered analyzer rules, architecture-test baselines, obsolete-field reads, cross-section stitching.

The English summary is being prepared. Showing the original description.

nobodies-collective/Humans4Updated Oct 22, 2026

Scrap and regenerate the in-flight EF migrations on the current branch as one consolidated migration. Use when migrations have accumulated mid-development cruft (added/removed columns, stacked add-column-to-existing-table fixes, hand-edited SQL that needs to come out, schema changes that should have been one migration but ended up as five), or when the branch has merged main and its migrations are now stuck mid-chain so `dotnet ef migrations remove` is unsafe. Triggers on phrases like 'regen the migrations', 'redo these migrations', 'scrap and regen migrations', 'consolidate the in-flight migrations', 'redo the migration stack', or any time an agent hits the mid-chain situation in `memory/architecture/migration-regen-after-rebase.md`.

The English summary is being prepared. Showing the original description.

nobodies-collective/Humans4Updated Oct 22, 2026

Use when a sprint tracking issue (label `sprint`) on peterdrier/Humans needs working — routine-fired cloud runs, or any unattended session told to execute the sprint queue.

The English summary is being prepared. Showing the original description.

nobodies-collective/Humans4Updated Oct 22, 2026

See all skills by nobodies-collective

Report a problem with this skill