skills/coding-standards/SKILL.md
Use this skill when writing, reviewing, or validating code (shell scripts, Python, Markdown) or CLI tools to ensure they follow repository coding standards and conventions. Also use when formatting git commit messages (Conventional Commits syntax, line wrapping) or checking code for style compliance. Triggers: coding standards, style guide, validate change, review conventions, shellcheck, shfmt, markdown format, python, ruff, uvx, lint, commit message format, CLI design, code review, formatting.
npx skillsauth add ithinkihaveacat/dotfiles coding-standardsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
This skill provides coding guidelines for making changes to codebases in this repository, as well as documentation for notations that agents may encounter.
All Markdown files must be formatted and linted with markdown-format. Use
standard heading styles without additional formatting or ALL CAPS. Do not add
numbers to headings.
@references/markdown.md
All Python files must be linted and formatted with ruff. Use uvx to run
tools. Target Python 3.11+.
@references/python.md
The language-agnostic authority for designing predictable and discoverable command-line interfaces (UI/UX). This includes command structure, help systems, output streams, and exit code philosophy.
@references/cli-tools.md
The language-specific implementation guide for shell scripts. All shell scripts
must be linted with shellcheck and formatted with shfmt. Fish scripts use
fish_indent. Scripts must have robust error handling and comply with the UX
standards in cli-tools.md.
@references/shell.md
Tools for working with Android Jetpack libraries, ADB operations, APK analysis, package management, Wear OS debugging, and emulator management.
@references/android.md
Agents must not commit changes automatically unless explicitly requested. Follow the specified commit message format.
@references/git.md
tools
Discover and select relevant agent skills based on a problem description, goal, or repository context. Use this to determine which skills apply to a workspace, or when you are unsure which tools are best suited for your current task.
development
Offers technical references and workflows for flight bookings and itinerary planning, focusing on Finnair booking URL parameter engineering. Use when generating, debugging, or analyzing Finnair booking URLs.
tools
Command-line tools that delegate analysis tasks to AI models and format up-to-date context for agents. Includes image description, screenshot comparison, smart cropping, token counting, technical essay generation, boolean condition evaluation, live context gathering, Android UI interaction via popper, GitHub PR/Issue/Workflow Run formatting via gh-markdown, and deep reasoning research via Oracle. Use this skill when the user needs to analyze images, count tokens, evaluate conditions, gather the latest authoritative documentation, format GitHub data, automate Android apps, generate technical essays, or perform complex architectural reasoning requiring recursive directory traversal and external search. Triggers: ai analysis, describe image, visual diff, token count, generate essay, boolean evaluation, gather context, latest docs, research topic, github, pull request, gh-markdown, automate app, oracle, deep research, architecture.
documentation
Use this skill when authoring, reviewing, or editing technical documents, including bug reports, known issues, friction logs, PR descriptions, and the structural content and tone of commit messages. Use to ensure engineering content maintains a clear, factual, and constructive tone. Triggers: technical writing, bug report, known issue, friction log, PR description, pull request, commit message tone, review document.