skills.rest
mdnaimul22
mdnaimul22COMMUNITY
Explore all skills by this author โ†’
GitHub

architecture-auditing-linter

Scan Python codebases for architecture and REST API violations.

2|Updated Apr 15, 2026
Search Tags:#static analysis#architecture audit#code compliance#AST linting#REST API scoring#refactoring tasks
One-click install
npx skills add https://github.com/mdnaimul22/human-skills --skill architecture-auditing-linter
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: architecture-auditing-linter
Source: https://github.com/mdnaimul22/human-skills/tree/main/skills/architecture-auditing-linter
Command: npx skills add https://github.com/mdnaimul22/human-skills --skill architecture-auditing-linter

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill requires asyncio, importlib.util, ast, pathlib, re, json, and includes scripts (resource) components.

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"}}'

Frequently Asked Questions about architecture-auditing-linter

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

FAQPage Schema
How do I scan a Python codebase for architecture compliance violations?โ–ผ

To scan a Python codebase for architecture compliance, you run an AST-based audit targeting logging, pathlib, and filesystem I/O violations. The linter analyzes your directory and outputs a violations report.

What is AST linting for code compliance and when should I use it?โ–ผ

AST linting for code compliance parses your source code to detect architectural drift like unsafe file I/O or silent exception swallowing. You use it to prevent standard violations and maintain code quality across a project.

Can I audit REST API best practices and generate refactoring tasks?โ–ผ

Yes, you can audit REST API best practices using the rest_api linter_type to score endpoint issues like versioning, auth, and rate limiting. When auditing a directory, it optionally generates a REFACTORING_TASKS.md file listing the violations.

Does the architecture linter support ignoring specific paths and rules?โ–ผ

Yes, the architecture linter supports ignoring specific paths and rules. You can pass the ignored_path argument to exclude directories like venv or tests, and use ignored_rules to bypass specific checks during the AST scan.

What's the best way to detect manual retry anti-patterns and silent exception swallowing?โ–ผ

The best way to detect manual retry anti-patterns and silent exception swallowing is using an AST-based linter. It scans your Python files to identify these error handling violations and reports them for refactoring.

Related Skills

Explore More Software Engineering Skillsโ†’
sunLeeesunLeee

generate-notebook-from-module

Generate Jupyter notebooks from Python module public APIs via AST parsing.

Community
Advanced
majiayu000majiayu000
12

skill

Route user requests to registered skill modules and execute them in context.

Community
Basic
VoDaiLoczVoDaiLocz
24

lint-and-validate

Automate linting and static analysis of code in CI pipelines.

Community
Intermediate
shawn-sandyshawn-sandy

wcag-compliance-reviewer

Identify WCAG 2.1 AA accessibility violations in HTML/CSS and React/TypeScript code.

Community
Intermediate