Skip to content
Back to skills

Value Specification

ASecurity

Translating organisational values and user expectations into system constraints.

  • 166 stars
  • 0 votes
  • 0 copies
  • 1 view
  • Added May 28, 2026
code-quality

Security analysis

A100/100

Scanned May 28, 2026

npx -y skills add Owl-Listener/ai-design-skills --skill value-specification --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Value Specification?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Value Specification
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/owl-listener-value-specification/badge)](https://www.skillsdirectory.com/skills/owl-listener-value-specification)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
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

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.