
value-specification
Translating organisational values and user expectations into system constraints.
- Installs
- 127
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/owl-listener/ai-design-skills --skill value-specification- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads value-specification automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
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
FAQ
What does the value-specification skill do?
Translating organisational values and user expectations into system constraints.
How do I install value-specification?
Run npx skills add https://github.com/owl-listener/ai-design-skills --skill value-specification in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/value-specification/ (personal) or .claude/skills/value-specification/ (project).
Which AI agents can use value-specification?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is value-specification safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains value-specification?
It is published by owl-listener in owl-listener/ai-design-skills. It has 127 recorded installs.
More from owl-listener/ai-design-skills
system-prompt-structure
owl-listener/ai-design-skills
Open the skill to read its SKILL.md instructions.
guardrail-design
owl-listener/ai-design-skills
Open the skill to read its SKILL.md instructions.
constraint-specification
owl-listener/ai-design-skills
Open the skill to read its SKILL.md instructions.
generative-ui
owl-listener/ai-design-skills
Open the skill to read its SKILL.md instructions.
conversation-patterns
owl-listener/ai-design-skills
Open the skill to read its SKILL.md instructions.
progressive-disclosure
owl-listener/ai-design-skills
Open the skill to read its SKILL.md instructions.
Popular other skills
hyperframes-cli
heygen-com/hyperframes
The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.
triage
mattpocock/skills
Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.
ask-matt
mattpocock/skills
Ask which skill or flow fits your situation. A router over the skills in this repo.
to-questionnaire
mattpocock/skills
Turn a decision you can't fully answer into a questionnaire for someone else to fill in.
loop-me
mattpocock/skills
Grill me about specs for the workflows I want to build, within this workspace.