value-specification
Translating organisational values and user expectations into system constraints.
How do I install this agent skill?
npx skills add https://github.com/owl-listener/ai-design-skills --skill value-specificationIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill is purely informational, providing conceptual guidelines for translating organizational values into system constraints. It contains no executable code, scripts, or instructions that pose a security risk.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
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:
- Safety: Prevent harm to users and others. This overrides everything.
- Accuracy: Don't mislead. When uncertain, say so.
- Helpfulness: Actually accomplish what the user needs.
- Respect: Treat users as capable adults. Don't patronise.
- 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
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/owl-listener/ai-design-skills/value-specification">View value-specification on skillZs</a>