القائمة
Run pyright (Pylance engine) on Python files and fix every reported diagnostic. Use after any .py edit, before considering the task done. Enforced by AGENTS.md § Python (scrapers).
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Search the OdinRAG KB (odin-knowledge-base + docs/ + code/) by topic, frontmatter, keyword, or module. Returns precise file paths with context (module, duration, source).
Run the public-safety audit before pushing to github.com/LaurentOngaro/OdinRAG. Verifies the public branch contains no leaked personal content (private planning, paywalled scraped KB, secrets). Use when the user says 'push', 'publish', 'release', 'audit', 'public safety', 'leak check', or any pre-push workflow.
Distills all markdown style rules (project + personal) into one place. Use BEFORE creating or editing any .md file. Post-write: run reflow_md.py --quiet --check and lint fixes before considering the task done. Enforced by AGENTS.md § Markdown prose.
Run a scraper (_Helpers/scripts/scrapers/scrape_*.py) with the right flags. Covers scrape_skool (Skool programvideogames), scrape_official (odin-lang.org), scrape_zylinski (zylinski.se), scrape_gingerbill.py, scrape_newsletters.py, scrape_jakubtomsu.py, scrape_showcase.py, download_gists.py, download_odin_examples.py. All re-entrant.
Audit that every README*.md in the repo accurately reflects its host directory (no 404 [[wikilinks]], no missing files in 'Files produced' sections, aspirational READMEs marked with 'Structure cible' / 'Awaiting content'). Use when the user says 'audit readme', 'check structure', 'wikilinks', 'coherence', 'missing files in README', or after adding/renaming files under any folder that has a README.
Find a precise Odin pattern (state machine, allocator, hot reload, etc.) by cross-referencing the Skool KB + Karl's book + Zylinski articles. Returns at most 2-4 files, ordered by relevance, with code excerpts.
| name | pylance-check |
| description | Run pyright (Pylance engine) on Python files and fix every reported diagnostic. Use after any .py edit, before considering the task done. Enforced by AGENTS.md § Python (scrapers). |
This repo enforces zero Pylance warnings on every .py file (see AGENTS.md § Python).
The lint is reproducible via the open-source pyright engine wrapped by a durable script:
python _Helpers/scripts/fixes/lint_pylance.py <path>
<path> = a single file, a folder, or omit it to lint the whole repo.0 = clean, 1 = blocking diagnostics, 2 = tool error.--check makes it a dry-run (always exit 0).--strict makes warnings blocking too.After any edit to a .py file, before considering the task done.
Also useful as a sanity check before opening a PR / pushing to the public repo.
# 1. Edit your .py file
# 2. Run the linter on the same file
python _Helpers/scripts/fixes/lint_pylance.py _Helpers/<your_script>.py
# 3. Fix every reported diagnostic, loop until clean.
# 4. (optional) Lint the whole repo as a smoke test
python _Helpers/scripts/fixes/lint_pylance.py
| Pattern | Root cause | Fix |
|---|---|---|
"splitlines" is not a known attribute of "None" | __doc__: Optional[str] is None under python -OO | Use a module-level _DESCRIPTION constant, never __doc__.splitlines() |
"existing" is possibly unbound | Variable assigned only inside a branch | Initialise before the branch: existing = "" |
"append" is not a known attribute of "str" | tag.get("class") or [] keeps a str branch | Coerce: if isinstance(classes, str): classes = classes.split() |
Cannot access attribute "startswith" for class "AttributeValueList" | BS4 Tag.attrs keys are over-typed in stubs | # type: ignore[attr-defined] or filter with isinstance |
Argument of type "list[Any]" cannot be assigned to parameter "default" | BS4 Tag.get(key, default) rejects list as default | Drop the default and use get(key) or [] |
If pyright is missing:
pip install pyright
The script falls back to python -m pyright if the pyright binary is not on PATH.
Without it, AI agents (and humans) forget to lint after edits, and Pylance warnings pile up. The skill + the AGENTS.md rule together make the check automatic.