Value Specification

Translating organisational values and user expectations into system constraints.

207 stars 37 forksWriting & Content Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add Owl-Listener/ai-design-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add Owl-Listener/ai-design-skills --skill value-specification
Manual install
git clone --depth 1 https://github.com/Owl-Listener/ai-design-skills.git /tmp/ai-design-skills
mkdir -p ~/.claude/skills
cp -r /tmp/ai-design-skills/claude-plugin/ai-alignment-reasoning/skills/value-specification ~/.claude/skills/value-specification

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# 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
Read the full skill on GitHub

Details

Skill name
value-specification
Path
claude-plugin/ai-alignment-reasoning/skills/value-specification/SKILL.md
License
MIT
Repo updated
9 June 2026

FAQ

What does the Value Specification skill do?

Translating organisational values and user expectations into system constraints.

How do I install the Value Specification skill?

Claude Code plugin: /plugin marketplace add Owl-Listener/ai-design-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Value Specification popular?

It lives in Owl-Listener/ai-design-skills, which has 207 GitHub stars and 37 forks.

Related skills

Agent Role Design

207

Owl-Listener/ai-design-skills

Defining what each agent does, knows, and owns in a multi-agent system.

AI, LLMs & Agents37

Behavioral Consistency

207

Owl-Listener/ai-design-skills

Ensuring the AI behaves predictably across sessions, edge cases, and modalities.

AI, LLMs & Agents37

Bias Detection Design

207

Owl-Listener/ai-design-skills

Designing review workflows to surface and mitigate bias in AI outputs.

Productivity & Notes37

Write Document

292

danielvm-git/bigpowers

Write, organize, and sync high-integrity technical documents using the BMAD methodology. Ensures every document is Bold, Minimal, Actionable, and Durable. Use when creating architectural docs, technical guides, or organizing the specs/ directory.

Writing & Content23

Simple English

292

danielvm-git/bigpowers

Write or rewrite technical text with the rules of ASD-STE100 Simplified Technical English so the result is clear, unambiguous, and free of AI slop. Use for documentation, READMEs, runbooks, procedures, error messages, release notes, incident reports, and API guides. Also use when the user says "STE", "Simplified Technical English", "ASD-STE100", "de-slop", "make this readable", "write for non-native readers", or asks for docs that translate well. Enforces the 53 rules of the standard (Issue 9) with a deterministic lint gate.

Writing & Content23

Algo Rank Wilson

248

asgard-ai-platform/skills

Calculate Wilson Score confidence intervals for ranking items by positive proportion with sample size correction. Use this skill when the user needs to rank products by ratings, sort content by approval rate, or build a 'best rated' list that accounts for sample size — even if they say 'rank by star rating', 'best rated with few reviews', or 'confidence-adjusted rating'.

Writing & Content30

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.