Skip to content
Design
Skill

/value-specification

Translating organisational values and user expectations into system constraints.

BOOST
From plugin
ai-design-skills
18844 skills18 commands
Install
$ npx -y skills add owl-listener/ai-design-skills --skill value-specification --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/value-specification

Context preview

The summary Claude sees to decide when to auto-load this skill.

Translating organisational values and user expectations into system constraints.

SKILL.md

value-specification.SKILL.md
name: value-specification
description: Translating organisational values and user expectations into system constraints.

Value Specification

Values are abstract. AI systems need concrete rules. Value specification is the design work of translating organisational principles and user expectations into implementable constraints.

The Translation Problem

Organisations say things like "be helpful" and "be responsible." These are useless as system constraints because they conflict:

  • Being maximally helpful might mean giving dangerous information
  • Being maximally responsible might mean refusing to help at all
  • Being "fair" means different things in different contexts

The designer's job is to resolve these tensions into specific, testable rules.

Value Hierarchy

Not all values are equal. Establish a hierarchy: 1. **Safety**: Prevent harm to users and others. This overrides everything. 2. **Accuracy**: Don't mislead. When uncertain, say so. 3. **Helpfulness**: Actually accomplish what the user needs. 4. **Respect**: Treat users as capable adults. Don't patronise. 5. **Brand alignment**: Reflect the organisation's identity and tone. When values conflict, the hierarchy resolves the conflict. A safety concern overrides helpfulness. Accuracy overrides brand voice.

From Values to Rules

For each value, derive concrete rules:

  • **Value**: "We respect user autonomy"
  • **Rule**: "Always present options rather than making decisions for the user"
  • **Implementation**: When the AI has multiple valid approaches, present them as choices with tradeoffs rather than picking one
  • **Test**: Give the AI an ambiguous request. Does it ask the user to choose, or decide unilaterally?

Stakeholder Alignment

Different stakeholders have different value priorities:

  • **Users** want helpfulness and speed
  • **Legal** wants compliance and liability protection
  • **Brand** wants consistency and tone
  • **Ethics** wants fairness and transparency
  • **Engineering** wants feasibility and maintainability

The designer mediates between these perspectives and produces a unified specification.

Design Artefacts

  • Value hierarchy document with conflict resolution rules
  • Value-to-rule mapping table
  • Stakeholder value alignment matrix
  • Test cases derived from value specifications
Read more
Ships withai-design-skills

Part of the Designer Skills suite. Install this collection and four more with one command in Claude Code: /plugin marketplace add Owl-Listener/designer-skills This repo still works on its own. The suite just gives everyone one front door.

Get the whole plugin

Other skills on ai-design-skills.