design-process-description
Skill1 starsChanged 23 days agoApache-2.0View on GitHub
Create, revise, or review a Process Description—the Purpose, observable Outcomes, boundaries, and necessary detail of work—including the body of an Agent Skill's SKILL.md. Use when defining or reviewing what work must achieve and how success is judged; designing the agents, tools, and environment that carry out the work is outside this Skill.
In this repository5 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- review-alpsSkill
- sync-localesSkill
- design-agent-work-systemSkill
The file
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 2 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
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
- Distinctive: line 29
Read the Process Framework and required references in full.
- Distinctive: line 54
Use findings to decide the further revision or review needed within the requested scope.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 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.
Files
Process Description Design
Purpose
Establish the adequacy of an understandable, applicable, and evaluable Process Description that makes the target work's purpose and success conditions clear with necessary and sufficient boundaries and detail, or make the description's deficiencies and limits explicit. This concerns work meaning, not the configuration that performs the work.
Outcomes
- The target work's Purpose and applicable scope, and its boundaries where adjacent work overlaps or the boundary is otherwise ambiguous, are identified in the description, or findings identify what is not identified.
- The description's Outcomes are observable result conditions individually necessary and collectively sufficient for the Purpose, or findings identify each unmet property.
- The description contains the detail needed to understand, apply, and evaluate the work and no detail that serves none of these, or findings identify missing or superfluous detail.
- Execution means remain open except where applicable conditions require them, or findings identify unnecessary fixing.
- Where the request involves changes, their affected elements, scope, rationale, consequences, and necessary revalidation are identified, or findings identify what remains unidentified.
- Where the request involves Process selection or changes to Process meaning, the choice is justified against the Purpose and applicable conditions, or findings identify what remains unjustified.
- The description's consistency with the Framework and required references is established or qualified by explicit findings.
- Unconfirmed matters and limits of application are explicit.
Activities & Tasks
The Tasks below are required within the requested scope, except where stated as recommendations. Their relationships support revisiting the description as understanding develops.
Work framing
- Read the Process Framework and required references in full.
- Identify the requested scope and the available description or information about the target work.
- Clarify the result the work undertakes to establish and its boundary with adjacent work using the necessary information from affected parties. Distinguish that responsibility from benefits or results belonging to other work.
- Confirm the source and applicability of that information and identify gaps; ask the requester where a gap could change the scope or success conditions and cannot be resolved from available information.
- Identify uncertainties that could change the intended scope or success conditions.
Success and work description
- Formulate observable Outcomes that are individually necessary and collectively sufficient for the Purpose. Keep independently assessable results distinguishable.
- Include detail where its absence would impair understanding, application, or evaluation; remove or combine repetitions that add none of these. Where work detail is needed, organize related actions into Activities and Tasks at a useful granularity and check their contribution to the Outcomes.
- Describe necessary Inputs, Outputs, Controls, Constraints, Enablers, and Entry/Exit Criteria by their function. Preserve required methods and dependencies with their scope and leave other execution choices open.
- For Markdown, apply the Framework's writing rules. When the target is an Agent Skill, use the body for the Process Description and the frontmatter for its discovery identifier and summary of the work and when it applies. Keep the frontmatter and Host displays consistent with the description's meaning and scope.
Source and relationship alignment
- Identify the description used as the reference point for meaning and confirm required references against their intended sources. Make the roles and conditions of required resources clear, and distinguish reference material from descriptions of work. For a Skill, verify that packaged links resolve in the intended distribution and that external references identify their sources and any access conditions.
- Clarify the meaning, use, and change effects of information shared with related work, including which work reads or updates it.
- For changes, establish the affected description and elements, scope, rationale, consequences, and necessary revalidation. Distinguish a change to the description used as the reference point for meaning, a context-limited change to what applies, and a change in presentation; distinguish all of these from a context-specific choice the description already permits, which is not a change to it.
- For Process selection or changes to Process meaning, evaluate proposed choices against the Purpose and applicable conditions using the evidence needed to justify the decision.
Description evaluation
- Evaluate the description against the Framework and applicable contextual requirements, including the coherence of its elements, whether Activities and Sub-processes describing the work as a whole cover every Outcome and contribute to the Purpose, and whether those describing only selected work identify the Outcomes they support. Confirm that the criteria and evidence apply to the description and context being reviewed.
- Re-evaluate affected criteria, evidence, and judgments when changed information or conditions affect their basis.
- Representative cases should be examined when they can expose ambiguity, unsupported success conditions, or limits of application, with effort proportionate to consequences, uncertainty, and complexity. Hold the Purpose, responsibility, scope, and applicable conditions fixed when considering counterexamples: could all Outcomes hold without fulfilling the Purpose, or could the Purpose be fully fulfilled without one of them? Could an Output exist or processing succeed while an Outcome does not hold? A changed responsibility is not a counterexample within the original scope; finding none does not prove sufficiency for every case.
- Use findings to decide the further revision or review needed within the requested scope.
- Report findings with evidence and affected scope. Distinguish confirmed nonachievement from missing evidence and justified inapplicability; retain supported results and useful partial work without treating them as full success. In a review, assess these Outcomes in the supplied description; a finding qualifies an Outcome by identifying the unmet condition, but it does not make the description meet that condition.
Controls
Apply the Process Framework for meaning and Markdown presentation. For Agent Skill targets, apply the Agent Skills specification to the physical format. These sources are required within their subjects.
Constraints
Changes must remain within the user's request and applicable environment conditions. A review-only request must be answered with findings and any requested corrections, without unsolicited changes. In creation or revision, findings may qualify an Outcome only for a condition that cannot be met within the requested scope, available information, or authority. Performing the described work or changing external state requires the applicable authorization. An unconfirmed reference or condition, including content of the Framework or a required reference that has not been read, must limit the dependent judgment or action; independent work may continue within its applicable conditions.
Resources
This root SKILL.md is the English source for the Japanese translation, which carries the same meaning and normative force.
- Minimal template: use when drafting an Agent Skill.
- Examples and review cases: consult relevant cases when checking success conditions, choosing work detail, describing shared information or views, or evaluating incomplete evidence.
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
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.

