architecture-auditing-linter

What problem does it solve?

This Skill prevents architecture drift by automatically scanning your codebase for standard violations in logging, pathlib usage, filesystem operations, error handling patterns, and REST API quality signals.

Core Features & Use Cases

• AST-based Architecture Audits (default mode): Detects violations like direct logging/pathlib imports, print() usage, unsafe file I/O, manual retry anti-patterns, silent exception swallowing, os.getenv access, and hardcoded logger filenames.
• REST API Quality Scoring (rest_api mode): Identifies endpoint issues across versioning, auth, rate limiting, pagination, idempotency, CORS, error handling, timeouts, request logging, response field filtering, sensitive data exposure, and other enterprise best-practice signals.
• Actionable Refactoring Tasks: Generates a REFACTORING_TASKS.md file listing detected violations as tracked tasks when you audit a directory.

Quick Start

Use this skill to audit your project and generate a refactoring task list by running: human-skills '{"tool_name":"linter","tool_args":{"linter_type":"default","scan_path":"./","ignored_path":"venv,.git,tests"}}'