Audit dictionary usage in public APIs and output a Markdown report.
npx skills add https://github.com/JordanGunn/skills --skill refactor-dictionaries
Please help me install this Agent Skill. Skill: refactor-dictionaries Source: https://github.com/JordanGunn/skills/tree/main/skills/refactor/dictionaries Command: npx skills add https://github.com/JordanGunn/skills --skill refactor-dictionaries
Audit dictionary usage against the Dictionary Usage Doctrine. The goal is to identify improper dictionary usage in public APIs and across module boundaries, ensuring explicit structure and typing and preventing dictionaries from acting as hidden state.
Run the audit against your codebase to generate a structured Markdown report.
High-intent search queries and answers about installing and using this skill.
You can audit dictionary usage by running this static analysis tool against your codebase to detect where Dict encodes known structure. It outputs a Markdown report with severity-based findings and minimal refactor recommendations.
You need to refactor dictionaries into TypedDict or dataclasses when they pass configuration, encode known structure, or cross module boundaries, acting as hidden state instead of explicit typed objects.
The best way to find improper dictionary usage across module boundaries is applying a Dictionary Usage Doctrine audit to classify findings by severity and propose minimal refactors like TypedDict or explicit objects.
Dictionary static analysis provides specific refactor recommendations by classifying findings by severity and proposing minimal structural changes to TypedDict, dataclass, or explicit objects in a summarized Markdown report.
Limitations of auditing dictionary usage include relying on the Dictionary Usage Doctrine to detect improper public API patterns, meaning it targets known structures and module boundaries rather than dynamic or arbitrary dictionary payloads.
bettercallfanExtract data flow relations from Python source code using static AST analysis.
DowwieAnalyze typing strategies, mutation patterns, and serialization in Python and TypeScript codebases.
HezziCodeEnforce Python type safety with mypy static type checking.
OneWave-AIReview code for security vulnerabilities, performance bottlenecks, and maintainability issues.
