Skip to main content
Version: 0.12.0

AS-012: Content Exceeds 500 Lines - Agent Skills

Summary​

  • Rule ID: AS-012
  • Severity: MEDIUM
  • Category: Agent Skills
  • Normative Level: SHOULD
  • Auto-Fix: No
  • Verified On: 2026-02-04

Applicability​

  • Tool: claude-code
  • Version Range: unspecified
  • Spec Revision: unspecified

Evidence Sources​

Test Coverage Metadata​

  • Unit tests: true
  • Fixture tests: true
  • E2E tests: false

Examples​

The following examples demonstrate what triggers this rule and how to fix it.

Invalid​

---
name: setup-env
description: Use when setting up the development environment
---
Step 1: Install Node.js
Step 2: Install npm packages
Step 3: Configure database
Step 4: Set environment variables
Step 5: Run migrations
Step 6: Seed data
Step 7: Start server
Step 8: Verify health check
Step 9: Run smoke tests
Step 10: Done
(imagine this continues for 500+ lines)

Valid​

---
name: setup-env
description: Use when setting up the development environment
---
Install dependencies and configure env vars.