preferred-tools

Files (1)

• SKILL.md

SKILL.md (first lines)

# Preferred Tools

To maintain consistency across the project, the following tools are preferred for common maintenance tasks:

- **Markdown Validation**: Use `markdownlint-cli2` for validating Markdown syntax.
- **Link Checking**: Use `lychee` for detecting broken internal and external links. It supports caching results to improve performance.
- **Git Hooks**: Use the `lefthook` framework via `lefthook.yaml` to run validations (like `prettier`, `markdownlint`, `shellcheck`, `lychee`, etc.) before each commit.
- **Formatting**: Use `prettier` for formatting Markdown, JSON, YAML, and TypeScript files. This is automatically managed via `lefthook` on staged files.
- **Library & Framework Documentation**: Prefer the **Context7 MCP tool** (`resolve-library-id` followed by `query-docs`) over web search for fetching up-to-date documentation and code examples for external libraries and frameworks.

Whenever possible, these tools should be invoked through Nix flakes (`nix flake check`).

From vorburger/aifiles, CC-BY-4.0.

More from vorburger/aifiles