MCPInstall

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
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads value-specification automatically when relevant.

  3. 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:

  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

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

View all →

system-prompt-structure

owl-listener/ai-design-skills

Open the skill to read its SKILL.md instructions.

AI & Agents455 installs

guardrail-design

owl-listener/ai-design-skills

Open the skill to read its SKILL.md instructions.

391 installs

constraint-specification

owl-listener/ai-design-skills

Open the skill to read its SKILL.md instructions.

374 installs

generative-ui

owl-listener/ai-design-skills

Open the skill to read its SKILL.md instructions.

Frontend & Design334 installs

conversation-patterns

owl-listener/ai-design-skills

Open the skill to read its SKILL.md instructions.

327 installs

progressive-disclosure

owl-listener/ai-design-skills

Open the skill to read its SKILL.md instructions.

318 installs

Popular other skills

View category →

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.

1.3M installs

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.

1M installs

ask-matt

mattpocock/skills

Ask which skill or flow fits your situation. A router over the skills in this repo.

778.4K installs

to-questionnaire

mattpocock/skills

Turn a decision you can't fully answer into a questionnaire for someone else to fill in.

508.9K installs

wait-what

mattpocock/skills

Stop. That last message did not land: re-pitch it.

459.7K installs

loop-me

mattpocock/skills

Grill me about specs for the workflows I want to build, within this workspace.

447.9K installs