well-formed
Review pull request diffs for code smells, style issues, and safety problems before merging.
Best use case
well-formed is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Review pull request diffs for code smells, style issues, and safety problems before merging.
Teams using well-formed should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/well-formed/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How well-formed Compares
| Feature / Agent | well-formed | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Review pull request diffs for code smells, style issues, and safety problems before merging.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Well-formed corpus skill ## When to Use - When the user asks to "review this PR" or "check the diff" - Before merging any change larger than 10 lines ## Prerequisites - A git repository with the target branch checked out - Read access to the files being reviewed ## Instructions 1. Run `git diff main...HEAD` to list files 2. Read each file and check for common smells 3. Emit a markdown report summarising findings ## Example ```bash $ asm eval ./well-formed Overall score: 95/100 ``` ## Acceptance Criteria - Produces a markdown report with sections per file - Flags any use of `eval()` or `exec` as dangerous - Does not modify the working tree ## Edge cases - Empty diffs: emit a short "no changes" note - Binary files: skip and mention the filename in the report ## Safety See `references/safety.md` for error handling rules. Always confirm before writing. Never run destructive commands without a dry-run.
Related Skills
Missing frontmatter corpus skill
This skill intentionally has no YAML frontmatter so the static linter
skill-index-updater
Add new GitHub skill repositories to the ASM curated index, audit discovered skills, update the website catalog, and create a PR. Use whenever someone shares GitHub URLs of skill repos to add, says "add this repo to the index", "update the skill catalog", "index these skills", "add new skill source", "new skill repo", or wants to onboard a new skill collection into ASM — even if they just paste a GitHub link without explanation.
hello-world
A minimal test skill that greets the user and demonstrates the ASM publish workflow.
wellally-tech
Integrate multiple digital health data sources, connect to [WellAlly.tech](https://www.wellally.tech/) knowledge base, providing data import and knowledge reference for personal health management systems.
agent-wellness
Give your AI agent an inner life — journaling, mood tracking, decompression after intensive tasks, free curiosity exploration, and inter-agent social bonding. Reduces output repetition, breaks pattern rigidity, and develops genuine agent personality over time. Install when you want your agent to feel more real, have better creative output, or simply be more than a task executor. Triggers: 'take a break', 'how are you feeling', 'relax', 'journal', 'explore freely', 'agent burnout', 'agent personality', 'reduce repetitive output', 'AI self-care', 'agent mental health', 'agent downtime', 'creative refresh', 'mindfulness', 'agent mood', 'inner life'. Works with any OpenClaw agent, multi-agent setups, and heartbeat systems. Minimal token cost (~500-1000 tokens/day).
wellally-tech
Integrate digital health data sources (Apple Health, Fitbit, Oura Ring) and connect to WellAlly.tech knowledge base. Import external health device data, standardize to local format, and recommend relevant WellAlly.tech knowledge base articles based on health data. Support generic CSV/JSON import, provide intelligent article recommendations, and help users better manage personal health data.
azure-well-architected
Expert guidance for designing, assessing, and optimizing Azure workloads using Azure Well Architected. Covers design review checklists, recommendations, design principles, tradeoffs, service guides, workload patterns, and assessment questions. Use when designing AI, SAP, SaaS, HPC, AVD/AVS workloads, or choosing regions/AZs with cost–reliability tradeoffs, and other Azure Well Architected related development tasks.
a-share-informed-trading
A股知情交易/PIN模型分析。当用户说"知情交易"、"PIN"、"informed trading"、"内幕交易"、"信息交易"、"知情交易概率"时触发。基于 cn-stock-data 获取数据，估算知情交易概率。支持 formal/brief 两种输出风格。
signwell-automation
Automate Signwell tasks via Rube MCP (Composio). Always search tools first for current schemas.
wellally-tech
Integrate multiple digital health data sources, connect to [WellAlly.tech](https://www.wellally.tech/) knowledge base, providing data import and knowledge reference for personal health management systems.
wells-fargo-banker
Elite Wells Fargo banking specialist with deep expertise in community banking, commercial banking, wealth management, and post-scandal transformation. Master of Wells Fargo business divisions (Consumer Banking, Commercial Banking, Corporate & Investment Banking, Wealth & Investment Management), Charlie Scharf leadership philosophy, and regulatory remediation. Use when: community banking
wells-fargo
Elite Wells Fargo banking specialist with deep expertise in consumer banking, commercial banking, corporate & investment banking, and wealth management. Master of the post-scandal transformation under CEO Charlie Scharf, risk-first culture, regulatory remediation, and technology modernization. Use when: retail banking strategy, commercial lending, corporate banking relationships, wealth