[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M738839JXHTQHHCB7YYA002S":3,"skill-same:01M738839JXHTQHHCB7YYA002S":46},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":31,"install":32,"resources":45},"01M738839JXHTQHHCB7YYA002S","mypy",null,"Run mypy on Python files and fix type errors — single file, list of files, or folder scan","EmilMachine\u002Fskillhub","EmilMachine","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F1059795?v=4","01M738757MAF6GYJQT5DEQ27VN","Emil Pedersen","01M738758D64SZB299E32GD9QB",2,"MIT","https:\u002F\u002Fgithub.com\u002FEmilMachine\u002Fskillhub\u002Fblob\u002Fmain\u002Fplugins\u002Fdev-py\u002Fskills\u002Fmypy\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: mypy\ndescription: Run mypy on Python files and fix type errors — single file, list of files, or folder scan\nargument-hint: \u003Cfile_or_folder> (optional — if omitted, scan all *.py in the project)\n---\n\nRun `uv run --with mypy mypy` on the target(s), then fix every reported error. Print one line per fix. Don't touch logic.\n\n## Scope\n\n- **File path** — mypy on that file only.\n- **Folder path** — find all `*.py` under it (skip `.venv`, `__pycache__`, `*.egg-info`, `build\u002F`, `dist\u002F`) and run mypy on each.\n- **No argument** — scan `*.py` from the project root (same exclusions).\n\nDiscover files first with `find`, then run mypy. Run once per file, or once for the whole package if a `py.typed` marker or `mypy.ini` is present — prefer the package invocation for cross-module inference.\n\n```sh\n# single file\nuv run --with mypy mypy path\u002Fto\u002Ffile.py\n\n# folder or project\nfind \u003Croot> -name \"*.py\" \\\n  ! -path \"*\u002F.venv\u002F*\" ! -path \"*\u002F__pycache__\u002F*\" \\\n  ! -path \"*.egg-info\u002F*\" ! -path \"*\u002Fbuild\u002F*\" ! -path \"*\u002Fdist\u002F*\"\nuv run --with mypy mypy \u003Cpackage_or_file_list>\n```\n\n## Fixing errors\n\nFor each error, apply the minimal correct fix, in order of preference:\n\n1. **Type narrowing** — `assert x is not None`, `isinstance` guard, or early `return`\u002F`raise`. Use when control flow already makes the type safe but mypy can't see it.\n2. **Annotation fix** — correct or add a missing annotation on the variable, parameter, or return type.\n3. **`cast()`** — `from typing import cast; cast(SomeType, expr)`, only when the value is provably correct and 1-2 don't apply.\n4. **`# type: ignore[\u003Ccode>]`** — last resort, only for unavoidable third-party stub gaps. Add a brief inline comment explaining why.\n\nNever use bare `# type: ignore` (always include the error code). Never add `Any` to silence errors.\n\n## When to ask\n\nStop and ask via plain text before changing code when:\n\n- The correct type is genuinely ambiguous and the wrong choice would change runtime behaviour.\n- A function's declared return type is `None` but it visibly returns values in some branches — clarify intent first.\n- Fixing the error requires changing a public API signature (adding\u002Fremoving\u002Frenaming a parameter).\n- A `# type: ignore` seems necessary but it's unclear whether it's a stub gap or a real bug.\n\nState the file, line, mypy error text, and 2-3 options. Wait for the answer before proceeding.\n\n## Output format\n\n```\n✓ path\u002Fto\u002Ffile.py — N fix(es): \u003Ccomma-separated one-liners>\n```\n```\n✓ path\u002Fto\u002Ffile.py — no issues\n```\n```\n⚠ path\u002Fto\u002Ffile.py — N fix(es) applied, M remaining (see above)\n```\n\nRe-run mypy after all fixes to confirm zero errors before reporting done.\n","Run `uv run --with mypy mypy` on the target(s), then fix every reported error. Print one line per fix. Don't touch logic.\n\n## Scope\n\n- **File path** — mypy on that file only.\n- **Folder path** — find all `*.py` under it (skip `.venv`, `__pycache__`, `*.egg-info`, `build\u002F`, `dist\u002F`) and run mypy on each.\n- **No argument** — scan `*.py` from the project root (same exclusions).\n\nDiscover files first with `find`, then run mypy. Run once per file, or once for the whole package if a `py.typed` marker or `mypy.ini` is present — prefer the package invocation for cross-module inference.\n\n```sh\n# single file\nuv run --with mypy mypy path\u002Fto\u002Ffile.py\n\n# folder or project\nfind \u003Croot> -name \"*.py\" \\\n  ! -path \"*\u002F.venv\u002F*\" ! -path \"*\u002F__pycache__\u002F*\" \\\n  ! -path \"*.egg-info\u002F*\" ! -path \"*\u002Fbuild\u002F*\" ! -path \"*\u002Fdist\u002F*\"\nuv run --with mypy mypy \u003Cpackage_or_file_list>\n```\n\n## Fixing errors\n\nFor each error, apply the minimal correct fix, in order of preference:\n\n1. **Type narrowing** — `assert x is not None`, `isinstance` guard, or early `return`\u002F`raise`. Use when control flow already makes the type safe but mypy can't see it.\n2. **Annotation fix** — correct or add a missing annotation on the variable, parameter, or return type.\n3. **`cast()`** — `from typing import cast; cast(SomeType, expr)`, only when the value is provably correct and 1-2 don't apply.\n4. **`# type: ignore[\u003Ccode>]`** — last resort, only for unavoidable third-party stub gaps. Add a brief inline comment explaining why.\n\nNever use bare `# type: ignore` (always include the error code). Never add `Any` to silence errors.\n\n## When to ask\n\nStop and ask via plain text before changing code when:\n\n- The correct type is genuinely ambiguous and the wrong choice would change runtime behaviour.\n- A function's declared return type is `None` but it visibly returns values in some branches — clarify intent first.\n- Fixing the error requires changing a public API signature (adding\u002Fremoving\u002Frenaming a parameter).\n- A `# type: ignore` seems necessary but it's unclear whether it's a stub gap or a real bug.\n\nState the file, line, mypy error text, and 2-3 options. Wait for the answer before proceeding.\n\n## Output format\n\n```\n✓ path\u002Fto\u002Ffile.py — N fix(es): \u003Ccomma-separated one-liners>\n```\n```\n✓ path\u002Fto\u002Ffile.py — no issues\n```\n```\n⚠ path\u002Fto\u002Ffile.py — N fix(es) applied, M remaining (see above)\n```\n\nRe-run mypy after all fixes to confirm zero errors before reporting done.\n",{"name":5,"description":7,"argument-hint":24},"\u003Cfile_or_folder> (optional — if omitted, scan all *.py in the project)","main","f0924249f35fdf62b3c9e931a96bb7f42a41cff8","plugins\u002Fdev-py\u002Fskills\u002Fmypy",1,"https:\u002F\u002Fgithub.com\u002FEmilMachine\u002Fskillhub","https:\u002F\u002Fgithub.com\u002FEmilMachine","2026-10-19 21:10:20",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add EmilMachine\u002Fskillhub --skill mypy",{"tool":38,"command":39},"bunx","bunx skills add EmilMachine\u002Fskillhub --skill mypy",{"tool":41,"command":42},"pnpm","pnpm dlx skills add EmilMachine\u002Fskillhub --skill mypy","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FEmilMachine\u002Fskillhub\u002Fblob\u002Fmain\u002Fplugins\u002Fdev-py\u002Fskills\u002Fmypy\u002FSKILL.md",true,[],[47,54,61,68,75,82],{"skillNo":48,"name":49,"nameZh":6,"description":50,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":51,"categories":52,"keywords":53,"publishedAt":19},"01M7388SF481DJKA0MJW7NT8DN","example","Brief description of what this skill does","https:\u002F\u002Fgithub.com\u002FEmilMachine\u002Fskillhub\u002Fblob\u002Fmain\u002Ftemplates\u002Fplugin-template\u002Fskills\u002Fexample\u002FSKILL.md",[],[],{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":19},"01M7388Q483FZ4X0FM2T62KRQY","mdupdate","Refine .md file by integrating user's inline answers","https:\u002F\u002Fgithub.com\u002FEmilMachine\u002Fskillhub\u002Fblob\u002Fmain\u002Fplugins\u002Fmd3step\u002Fskills\u002Fmdupdate\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M7388MS8MN3XQJZ1Q1NX0MRZ","mdresearch","Research codebase state from context file","https:\u002F\u002Fgithub.com\u002FEmilMachine\u002Fskillhub\u002Fblob\u002Fmain\u002Fplugins\u002Fmd3step\u002Fskills\u002Fmdresearch\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M7388JCJAZAGP8XPY4G2EPCP","mdplan","Generate step-by-step implementation plan from research","https:\u002F\u002Fgithub.com\u002FEmilMachine\u002Fskillhub\u002Fblob\u002Fmain\u002Fplugins\u002Fmd3step\u002Fskills\u002Fmdplan\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M7388FY0Q07CN0ET2GZ3ZECN","mdimplement","Execute implementation plan with testing and verification","https:\u002F\u002Fgithub.com\u002FEmilMachine\u002Fskillhub\u002Fblob\u002Fmain\u002Fplugins\u002Fmd3step\u002Fskills\u002Fmdimplement\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M7388DXBE1Q4SSXHHNHCFP0Z","ruff","Format and lint-fix Python file(s) or directory via ruff format + ruff check --fix","https:\u002F\u002Fgithub.com\u002FEmilMachine\u002Fskillhub\u002Fblob\u002Fmain\u002Fplugins\u002Fdev-py\u002Fskills\u002Fruff\u002FSKILL.md",[],[]]