scan-documentation

Scan SNC platform code for missing JSDoc comments and generate Fix-lane findings.

Updated Mar 4, 2026
One-click install
npx skills add https://github.com/sncollective/snc-platform --skill scan-documentation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scan-documentation
Source: https://github.com/sncollective/snc-platform/tree/main/.claude/skills/scan-documentation
Command: npx skills add https://github.com/sncollective/snc-platform --skill scan-documentation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Ensures that the SNC platform’s codebase has comprehensive JSDoc documentation, preventing undocumented exported APIs, service contracts, shared utilities, and complex React components from slipping through review.

Core Features & Use Cases

  • Scans exported functions, service-layer contracts, and shared package exports for missing documentation.
  • Reviews React components with three or more props to ensure purpose comments are present.
  • References detailed rule specifications stored in the skill’s references/ directory.
  • Outputs findings formatted for the refactor board’s Fix lane, grouped by file.

Quick Start

Run the scan-documentation skill to produce a list of undocumented items in the SNC repository.

Frequently Asked Questions about scan-documentation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check my codebase for missing JSDoc comments?

Scanning for missing JSDoc involves auditing exported functions, service-layer contracts, and shared utilities against Always-tier documentation rules. It checks React components with three or more props for purpose comments and outputs findings formatted for the refactor board's Fix lane.

How do I audit exported functions and React components for JSDoc coverage?

Auditing JSDoc coverage requires scanning exported functions, service-layer contracts, and React components with three or more props. The scanner references detailed rule specifications to identify missing documentation and groups findings by file for the refactor board's Fix lane.

Does the JSDoc scanner exclude certain code tiers during the audit?

Yes, the JSDoc scanner explicitly excludes Skip-tier code during the audit process. It focuses strictly on Always-tier documentation rules, ensuring exported functions, service-layer contracts, and shared package exports are fully documented without processing excluded files.

What is the best way to format missing JSDoc findings for a refactor board?

The best way to format missing JSDoc findings is to group them by file and structure the output specifically for the refactor board's Fix lane. This approach ensures undocumented exported functions and complex React components are tracked systematically.

When do I need to scan JSDoc comments for React components?

You need to scan JSDoc comments for React components when they have three or more props, ensuring purpose comments are present. This process enforces Always-tier documentation rules across exported functions and shared package exports.

Can I use JSDoc scanning to audit service-layer contracts in TypeScript?

Yes, you can use JSDoc scanning to audit service-layer contracts in TypeScript. The scanner identifies missing documentation across shared package exports and complex React components, formatting the undocumented items for the refactor board.