agentsclimarketplace

Clarify domain docs

Skill Mergemat/agent-readiness-skills/skills/clarify-domain-docs

Harness-agnostic skills for agent-readable repos and task prep

Install
npx -y skills add Mergemat/agent-readiness-skills --skill clarify-domain-docs

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

2 things to look at

  • no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
  • 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 author says it does

Copied from the file, not written here

Clarifies project language and durable decisions, then records them in CONTEXT.md and ADRs. Use when a plan has fuzzy terms, domain concepts are overloaded, user wants shared language, or decisions should be captured before implementation.

SKILL.md

1.3 KB, 238 tokens by cl100k_base, as published. Nobody here has run it

Clarify Domain Docs

Resolve language and decisions before implementation.

Ask one question at a time. If code can answer the question, inspect the code instead of asking.

Process

  1. Read existing CONTEXT.md, CONTEXT-MAP.md, and relevant ADRs.
  2. Identify overloaded, vague, or conflicting terms.
  3. Challenge terms against code and docs.
  4. Propose one canonical term and definition.
  5. Update CONTEXT.md when a term is resolved.
  6. Offer an ADR only for decisions that are hard to reverse, surprising, and trade-off driven.

Use context-format.md and adr-format.md only when writing.

Rules

  • CONTEXT.md is a glossary, not a spec.
  • Keep definitions one or two sentences.
  • Do not include implementation details in glossary entries.
  • Do not create ADRs for obvious or temporary choices.
  • If multiple contexts exist, update the relevant context only.

Output

End with:

  • resolved terms
  • changed docs
  • decisions recorded or deliberately not recorded
  • remaining open questions

What ships with it: 2 files

1.3 KB alongside SKILL.md

references/

Keep looking

Skills are one crate of 326,984. 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.