agentsclimarketplace
Sign in

Aiready best practices

Skill getaiready/aiready-skills/aiready-best-practices

Guidelines for writing AI-friendly code. Detects semantic duplicates, context fragmentation, naming inconsistencies. Use when writing new code, reviewing PRs, refactoring for AI adoption, or debugging AI assistant confusion. Helps minimize context waste and improve AI comprehension.From its SKILL.md

Install
npx -y skills add getaiready/aiready-skills --skill aiready-best-practices

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its file declares

Copied from the file, not written here

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

1.8 KB, 273 tokens by cl100k_base, as published. Nobody here has run it

AIReady Best Practices

Guidelines for writing AI-friendly codebases that AI coding assistants can understand and maintain effectively. Based on analysis of thousands of repositories and common AI model failure patterns. Covers pattern detection, AI signal clarity, context optimization, change amplification, agent grounding, consistency checking, documentation, testability, and dependency management.

Core Capabilities

  1. AI Signal Clarity: Principles for reducing ambiguity in code.
  2. Context Optimization: Strategies for minimizing context window waste.
  3. Pattern Detection: Identifying and consolidating semantic duplicates.
  4. Consistency: Maintaining uniform naming and architectural patterns.
  5. Health Assessment: Using aiready scan for proactive codebase auditing.

Usage for Agents

Full instructions are available in AGENTS.md.

[!NOTE] AGENTS.md is automatically generated from individual rules in the rules/ directory. Contributors should modify the source rules rather than the compiled file.

Quick Commands (via npx)

  • Measure Health: npx @aiready/cli scan .
  • Check Consistency: npx @aiready/cli consistency .
  • Detect Duplicates: npx @aiready/cli patterns .

What ships with it: 23 files

64.8 KB alongside SKILL.md

rules/

Keep looking

Skills are one crate of 326,750. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.