{"owner":"huangsam","repo":"ultimate-python","hasSkills":true,"totalSkillsCount":1,"totalTokensCount":279,"categories":["root-instruction"],"hasMcp":false,"mcpConfig":null,"found":["AGENTS.md"],"skills":{"AGENTS.md":"# Quick orientation for AI coding agents\n\n## Architecture & Conventions\n\n- **Standard library only**: Lessons in `ultimatepython/` strictly use the Python standard library. No external runtime dependencies, external services, or network calls.\n- **Lesson structure**: Docstring, helper definitions, parameterless idempotent `main()` with assertions for verification, and `if __name__ == \"__main__\": main()`.\n- **Runner discovery**: `runner.py` dynamically discovers modules under `ultimatepython/` and executes `main()`.\n- **Web UI (`ui/`)**: An Astro + TypeScript application for browsing lessons. Lessons are parsed by `ui/parse_lessons.py`.\n\n## Verification & Commands\n\nRun `./pre-commit.sh` to run the full Python verification suite:\n- **Lint & Format**: `ruff check` and `ruff format`\n- **Type Checking**: `mypy ultimatepython check_readmes.py runner.py`\n- **README Sync**: `python check_readmes.py` (verifies header hierarchy and lesson links)\n- **Tests & Coverage**: `coverage run runner.py` and `coverage report` (target >= 80%)\n- **Single Lesson**: `python ultimatepython/<category>/<module>.py`\n- **UI Checks**: `npm run lint` (`astro check`) and `npm run build` in `ui/`\n"},"files":{"AGENTS.md":"# Quick orientation for AI coding agents\n\n## Architecture & Conventions\n\n- **Standard library only**: Lessons in `ultimatepython/` strictly use the Python standard library. No external runtime dependencies, external services, or network calls.\n- **Lesson structure**: Docstring, helper definitions, parameterless idempotent `main()` with assertions for verification, and `if __name__ == \"__main__\": main()`.\n- **Runner discovery**: `runner.py` dynamically discovers modules under `ultimatepython/` and executes `main()`.\n- **Web UI (`ui/`)**: An Astro + TypeScript application for browsing lessons. Lessons are parsed by `ui/parse_lessons.py`.\n\n## Verification & Commands\n\nRun `./pre-commit.sh` to run the full Python verification suite:\n- **Lint & Format**: `ruff check` and `ruff format`\n- **Type Checking**: `mypy ultimatepython check_readmes.py runner.py`\n- **README Sync**: `python check_readmes.py` (verifies header hierarchy and lesson links)\n- **Tests & Coverage**: `coverage run runner.py` and `coverage report` (target >= 80%)\n- **Single Lesson**: `python ultimatepython/<category>/<module>.py`\n- **UI Checks**: `npm run lint` (`astro check`) and `npm run build` in `ui/`\n"},"items":[{"name":"AGENTS.md","path":"AGENTS.md","rawUrl":"https://raw.githubusercontent.com/huangsam/ultimate-python/HEAD/AGENTS.md","title":"AI Agent Protocol & Instructions","category":"root-instruction","format":"markdown","content":"# Quick orientation for AI coding agents\n\n## Architecture & Conventions\n\n- **Standard library only**: Lessons in `ultimatepython/` strictly use the Python standard library. No external runtime dependencies, external services, or network calls.\n- **Lesson structure**: Docstring, helper definitions, parameterless idempotent `main()` with assertions for verification, and `if __name__ == \"__main__\": main()`.\n- **Runner discovery**: `runner.py` dynamically discovers modules under `ultimatepython/` and executes `main()`.\n- **Web UI (`ui/`)**: An Astro + TypeScript application for browsing lessons. Lessons are parsed by `ui/parse_lessons.py`.\n\n## Verification & Commands\n\nRun `./pre-commit.sh` to run the full Python verification suite:\n- **Lint & Format**: `ruff check` and `ruff format`\n- **Type Checking**: `mypy ultimatepython check_readmes.py runner.py`\n- **README Sync**: `python check_readmes.py` (verifies header hierarchy and lesson links)\n- **Tests & Coverage**: `coverage run runner.py` and `coverage report` (target >= 80%)\n- **Single Lesson**: `python ultimatepython/<category>/<module>.py`\n- **UI Checks**: `npm run lint` (`astro check`) and `npm run build` in `ui/`\n","isInternal":false,"tokens":279,"sizeBytes":1182}],"systemPromptSnippet":"<yakaai_skills repo=\"huangsam/ultimate-python\">\n<!-- File: AGENTS.md (Tokens: ~279 | Category: root-instruction) -->\n# Quick orientation for AI coding agents\n\n## Architecture & Conventions\n\n- **Standard library only**: Lessons in `ultimatepython/` strictly use the Python standard library. No external runtime dependencies, external services, or network calls.\n- **Lesson structure**: Docstring, helper definitions, parameterless idempotent `main()` with assertions for verification, and `if __name__ == \"__main__\": main()`.\n- **Runner discovery**: `runner.py` dynamically discovers modules under `ultimatepython/` and executes `main()`.\n- **Web UI (`ui/`)**: An Astro + TypeScript application for browsing lessons. Lessons are parsed by `ui/parse_lessons.py`.\n\n## Verification & Commands\n\nRun `./pre-commit.sh` to run the full Python verification suite:\n- **Lint & Format**: `ruff check` and `ruff format`\n- **Type Checking**: `mypy ultimatepython check_readmes.py runner.py`\n- **README Sync**: `python check_readmes.py` (verifies header hierarchy and lesson links)\n- **Tests & Coverage**: `coverage run runner.py` and `coverage report` (target >= 80%)\n- **Single Lesson**: `python ultimatepython/<category>/<module>.py`\n- **UI Checks**: `npm run lint` (`astro check`) and `npm run build` in `ui/`\n</yakaai_skills>"}