agentleFS
mikezangusmikezangus/agent-skills/representation-design/SKILL.md

representation-design

Skill0 starsChanged 29 days agoMITView on GitHub

Design and review representations of information and behavior. Use when choosing names, definitions, categories, or encodings, or when converting or rewriting material while preserving required meaning and distinctions.

The file

We split this skill into the rules it gives an agent

4 rules. About 0 are common, 4 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈4

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use established dependencies to identify constraints and missing prerequisites within the authorized work.

    line 17
  2. Distinctive:

    Use the required outcomes to identify differences that need different answers or actions.

    line 58
  3. Distinctive:

    Keep the subject's state distinguishable from the information available about that state.

    line 78
  4. Distinctive:

    Use the actual interpretation and validation methods of the relevant language, discipline, or tool.

    line 120

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Establish required use

Interpret the request in its available context. Distinguish the result sought, the work authorized, and the choices the request fixes or leaves open. Support each consequential interpretation through the request and applicable rules. Use established dependencies to identify constraints and missing prerequisites within the authorized work. Determine separately what the result must accomplish and how it is to be presented.

For an example or comparison, identify the relationship it illustrates or the claim it challenges and the scope the request assigns to it. Establish which features affect the required result. For a proposed term, method, or arrangement, determine whether the request adopts it, requires its examination, or permits alternatives.

Compare readings that would change the result or authorized work against the available context. Investigate a missing fact; make a delegated choice within its stated constraints; obtain clarification for a remaining difference that changes what is required or permitted. Continue work whose validity is independent of that unresolved difference.

Derive the required answers, decisions, and behavior from the request, supporting facts, and applicable rules. Use that basis to determine which instructions apply and what the result must express or enable.

For each required answer, decision, or behavior, determine the permitted outcomes and the information needed to assess them. Select an examination method that can distinguish satisfaction from a discrepancy. Establish these criteria from the task and supporting information independently of a proposed result.

Identify the intended readers or consuming systems and their available information, conventions, and means of interpretation. Determine which information they need for the required answers, decisions, or behavior. Establish how the selected content contributes to that use, separately from what supports its truth or accuracy. Distinguish that content from information used to prepare or assess the result.

Identify the evidence for factual assertions, the authority for requirements, and the identifiers or expressions whose form is fixed. Determine which uncertainties and choices the task permits and which missing facts prevent a required decision. Obtain the missing facts through authorized means or identify the decision they prevent.

Select distinctions and expressions

Use the required outcomes to identify differences that need different answers or actions. Determine what information distinguishes those cases. Preserve it in the result or through a source available at its point of use.

Determine which differences can be treated alike without changing a required outcome. Select detail through the distinctions retained and the work needed to recover them. Establish category membership, comparisons, and limits from the task, evidence, or adopted rules. Identify a missing criterion and the decision it prevents. State a proposed criterion and its consequences as a proposal.

For each required conclusion, identify the expressions, values, or relationships from which it can be recovered. Establish a distinction before choosing its name. Supply the meaning through characteristics, relationships, or established conventions available to the intended reader or consuming system.

Identify the participants, direction, conditions, and scope of each consequential relationship. Use an expression consistently for its stated meaning. Distinguish meanings that require different conclusions or actions.

Keep the subject's state distinguishable from the information available about that state. Preserve the status of facts, estimates, unknowns, proposals, permissions, and requirements where it affects the required use.

Compare candidate forms through the distinctions they retain, the conclusions they support, and the work their interpretation requires. Select a form interpretable under the task's constraints and available conventions.

Construct or assess the result

Produce the construction, transformation, or assessment requested by the task using the selected distinctions and expressions. Preserve the wording, identifiers, and forms fixed by the task or applicable authority.

For a transformation, determine what must remain true or distinguishable and which changes in meaning or behavior are authorized. Compare the source basis and proposed result for added, removed, combined, separated, or changed distinctions. Evaluate the change through the conclusions and actions it permits. Establish byte identity or reversibility where the task requires those properties.

Express uncertainty and permitted choices according to the supporting information. Resolve differences between interpretations where the task requires deciding between their consequences. Preserve remaining open choices within their stated conditions.

Examine interpretation and preservation

For each applicable requirement, recover the answer, decision, or behavior from the current result using the information available to its intended consumer. Resolve references and definitions through the conventions and sources available to that consumer. Identify competing readings that those conventions and that information permit and that change a required answer, decision, or behavior. Compare each recovered outcome with what the task and supporting information establish. Identify the relevant part of the result, examination method, supporting evidence, and finding.

Select cases that distinguish interpretations with different required outcomes. Include possibilities the supporting information leaves open and outcomes the requirements exclude. Compare what the result permits in those cases with what the task permits or requires. Trace added certainty, restrictions, or choices to their evidence or authority.

Use the actual interpretation and validation methods of the relevant language, discipline, or tool. Establish required execution from observations of performed actions. Distinguish faithful preservation of an assertion from establishing its truth, and retained information from information its intended consumer can recover.

Compare the requirements and applicable procedural actions with the completed examinations. If that comparison establishes an omitted check, unsupported finding, or discrepancy, identify the requirement and information that expose it.

Correct discrepancies and determine completion

For an established discrepancy, locate the responsible information, expression, relationship, interpretation, or assessment criterion. Return to that decision and correct it within the task's authority. In an assessment-only task, present the supported correction as a proposal.

Re-examine the changed result and the meanings or uses affected by the change. A changed requirement or supporting fact also requires reconsidering the decisions and examinations that depend on it. Continue correction where the new examination establishes a remaining discrepancy.

Determine whether each unresolved point is a permitted uncertainty or choice, or leaves required work unfinished. Obtain the information or authorization needed for unfinished work where the task permits. Otherwise identify what remains required and what prevents establishing it.

Deliver the requested result as complete when examination of that result establishes satisfaction of each applicable requirement and required procedural action. Base the completion judgment on those findings and their evidence.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.