.github/skills/lint-markdown/SKILL.md
Check and fix formatting and other issues in markdown files using markdownlint-cli2.
npx skillsauth add azure/azure-sdk-for-rust lint-markdownInstall 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.
Check markdown files for common mistakes.
Run npm ci from this skill directory (.github/skills/lint-markdown/) first. Then run commands using npm exec --prefix .github/skills/lint-markdown -- markdownlint-cli2 <command> from the repository root.
Configuration is in .markdownlint-cli2.yaml files. The root configuration is at the repository root.
For markdownlint rules configuration, nest it under the config property following the markdownlint schema at https://raw.githubusercontent.com/DavidAnson/markdownlint/main/schema/markdownlint-config-schema.json. Use friendly rule names (e.g., line-length) instead of codes (e.g., MD013).
Run npm exec --prefix .github/skills/lint-markdown -- markdownlint-cli2 from the repository root with a list of modified markdown files to lint.
Run with the --fix flag with a list of modified markdown files to automatically fix supported issues:
npm exec --prefix .github/skills/lint-markdown -- markdownlint-cli2 --fix
Run the same lint command again to verify all issues are fixed. There should be no errors reported.
development
Enforce consistent struct design conventions across sdk/cosmos crates. Validates visibility modifiers, field privacy, #[non_exhaustive] usage, and construction API patterns (`Default`/`new` with `with_*` setters, or optional separate builders with `builder()`/`build()`), and construction correctness on public structs. Can auto-fix violations or report them as errors.
development
Run pre-commit checks for a specific set of crates. Use this when validating changes under sdk/cosmos before committing or during code review.
tools
Update the TypeSpec emitter for Rust and optionally regenerate all clients
development
Create a new Azure SDK crate from a TypeSpec specification.