Home / runkids / skillshare · .skillshare/skills/skillshare-codebase-audit/SKILL.md · GitHub

skillshare-codebase-audit skillA

skillshare-codebase-audit is agent-read markdown (skill) from runkids/skillshare: Cross-validate CLI flags, docs, tests, and targets for consistency across the codebase. Use this skill whenever the user asks to: audit the codebase, check for consistency issues, find undocumented flags, verify test coverage, validate targets.yaml, check handler split conventions, or verify oplog instrumentation. This is a read-only audit — it reports issues but never modifies files. Use after large refactors, before releases, or whenever you suspect docs/code/tests have drifted out of sync..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

Read-only consistency audit across the skillshare codebase. $ARGUMENTS specifies focus area (e.g., "flags", "tests", "targets") or omit for full audit.

**Scope**: This skill only READS and REPORTS. It does not modify any files. Use `implement-feature` to fix issues or `update-docs` to fix documentation gaps.

## Audit Dimensions

Run all 4 dimensions in parallel where possible. For each, produce a summary table.

### 1. CLI Flag Audit

Compare every flag defined in `cmd/skillshare/*.go` against `website/docs/commands/*.md`.

```bash
# Find all flags in Go source
grep -rn 'flag\.\(String\|Bool\|Int\)' cmd/skillshare/
grep -rn 'Args\|Usage' cmd/skillshare/
```

Report:
- **UNDOCUMENTED**: Flag exists in code but not in docs
- **STALE**: Flag documented but not found in code
- **OK**: Flag matches between code and docs

### 2. Spec vs Code

For each spec in `specs/` marked as completed/done:
- Verify the described feature exists in source code
- Check that the spec's acceptance criteria are testable

Report:
- **IMPLEMENTED**: Spec complete, code exists
- **MISMATCH**: Spec says done but code missing or partial
- **PENDING**: Spec not yet marked complete (informational)
…

Read the whole file at its exact version.

How to install

Latest version
mdr add runkids/skillshare/skillshare-codebase-audit@git:20260325.68111d2
Exact content
mdr add runkids/skillshare/skillshare-codebase-audit@sha256:1ec3dbfe757b9a63

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_gjp6ziajifbniz6k.svg)](https://markdownregistry.com/a/art_gjp6ziajifbniz6k)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260325.68111d2 latest2026-03-25 68111d2 7,328 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (7328 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

runkids/skillshare · 2,689 stars · license MIT · pushed 2026-09-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_gjp6ziajifbniz6k
GET https://markdownregistry.com/api/v1/resolve?ref=runkids/skillshare/skillshare-codebase-audit
GET https://markdownregistry.com/api/v1/blob/1ec3dbfe757b9a63b9f34d5d7e463c0844f733c21a48d8882c687671849247a8

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from runkids/skillshare

skillshare-changelog skill
runkids/skillshare · .skillshare/skills/skillshare-changelog/SKILL.md · Generate CHANGELOG.md entry from recent commits in conventional format. Also syncs the website changelog page. Use this…
git:20260405.162f5e3 · audit A · 2,689 stars
skillshare-cli-e2e-test skill
runkids/skillshare · .skillshare/skills/skillshare-cli-e2e-test/SKILL.md · Run isolated E2E tests in devcontainer from ai_docs/tests runbooks. Use this skill whenever the user asks to: run an…
git:20260325.68111d2 · audit B · 2,689 stars
skillshare-devcontainer skill
runkids/skillshare · .skillshare/skills/skillshare-devcontainer/SKILL.md · Run CLI commands, tests, and debugging inside the skillshare devcontainer. Use this skill whenever you need to: execute…
git:20260918.4bcd569 · audit A · 2,689 stars
skillshare-implement-feature skill
runkids/skillshare · .skillshare/skills/skillshare-implement-feature/SKILL.md · Implement a feature from a spec file or description using TDD workflow. Use this skill whenever the user asks to: add a…
git:20260918.4bcd569 · audit A · 2,689 stars
skillshare-release skill
runkids/skillshare · .skillshare/skills/skillshare-release/SKILL.md · End-to-end release workflow for skillshare. Runs tests, generates changelog (via /changelog), optionally writes local…
git:20260615.5941891 · audit A · 2,689 stars
skillshare-ui-website-style skill
runkids/skillshare · .skillshare/skills/skillshare-ui-website-style/SKILL.md · Skillshare frontend design system for the React dashboard (ui/) and Docusaurus website (website/). Use this skill…
git:20260918.4bcd569 · audit A · 2,689 stars
skillshare-update-docs skill
runkids/skillshare · .skillshare/skills/skillshare-update-docs/SKILL.md · Update website docs to match recent code changes, cross-validating every flag against source. Use this skill whenever…
git:20260325.68111d2 · audit A · 2,689 stars
skillshare skill
runkids/skillshare · skills/skillshare/SKILL.md · Manage skills, agents, extras, plugins, and MCP connection settings with the Skillshare CLI. Use when the user asks to…
v0.21.7 · audit A · 2,689 stars
AGENTS.md@website agents
runkids/skillshare · website/AGENTS.md
git:20260920.7250fc8 · audit A · 2,689 stars

Every file in runkids/skillshare

Browse by kind, by grade A, or by owner.