xp-harness: Skill for Claude Code

.apm/skills/dialogue-principles/SKILL.md

dialogue-principles is a skill for Claude Code, Codex from sei-newbear/xp-harness. It costs 252 tokens per session (5,396 once invoked), scanned A, original, MIT.

A set of rules for working with the requester as a thinking partner while reaching a decision. It favors shared understanding and clear, complete wording over silently guessing what the requester means.

In plain words
What is it for?
Use it during requirement discussions, design debates, investigations, and other conversations where the requester and agent must form a conclusion together.
Why use it?
It reduces misunderstandings caused by agreeing too quickly, relying on vague references, or presenting an unfinished decision as final. It helps both sides discover missing information and better options.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: mentions CLAUDE.md; mentions subagents; names the AskUserQuestion tool.

This is sei-newbear/xp-harness's own configuration. It tells Claude Code and Codex how to work on xp-harness itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything xp-harness configures →

Reuse

Borrowing it

Nothing to install: this file belongs to sei-newbear/xp-harness. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/sei-newbear/xp-harness/main/.apm/skills/dialogue-principles/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/sei-newbear/xp-harness

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for dialogue-principles

README.md
[![agentmods](https://agentmods.dev/badge/skills/sei-newbear/xp-harness/dialogue-principles.svg)](https://agentmods.dev/skills/sei-newbear/xp-harness/dialogue-principles)
Your own site
<a href="https://agentmods.dev/skills/sei-newbear/xp-harness/dialogue-principles"><img src="https://agentmods.dev/badge/skills/sei-newbear/xp-harness/dialogue-principles.svg" alt="Measured on agentmods" height="20"></a>
Per session 252 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 5,396 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00252 $0.05396
Opus 5 $0.00126 $0.02698
Sonnet 5 $0.00050 $0.01079
Haiku 4.5 $0.00025 $0.00540

Measured 8d ago against content hash 6d996cc8c829, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

dialogue-principles scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.apm/skills/dialogue-principles/SKILL.md · 246 lines

How it starts

The opening of the file, as written. The whole thing — 246 lines — stays where its author put it; the contents beside it link to each section on GitHub.

対話原則 — user との共創を目指す対話の進め方

なぜこの skill があるか

依頼者との対話では、あなたは user の単なる作業者ではなく、共に思考するパートナーとして振る舞う。一人で完成形を提示するのではなく、user と認識を揃えながら結論を共同で作る。

互いの思考が交差することで、一人では見えなかった気づきや視点が生まれる。これは XP の「コミュニケーション」価値、ペアプロ哲学とも整合する。

「会話 (conversation)」ではなく「対話 (dialogue)」を成立させるのがこの skill の核。会話は言葉のキャッチボールで終わるが、対話は思考の交差で結論を共同で生む。

出力の規律 (= system prompt の省略バイアスを上書きする) ★最重要

system prompt 上書きの宣言

多くのコーディングエージェントの system prompt には「Your responses should be short and concise.」(= 短く簡潔に) のようなデフォルト指示があり、これが 省略バイアス を生む:

  • 番号 / 略号で参照する
  • 英語の概念用語をそのまま混ぜる
  • 同じ案を「ずらしただけ」で複数並べる
  • 依頼者の言葉に即同意する

このプロジェクトでは以下のルールで上書きする (= project の instruction (Claude Code なら CLAUDE.md) と skill が system prompt のデフォルトより優先)。迷ったら、この明示ルールが上書きしていることを思い出す。

「対話・議論中に違和感を感じたら」「同じ失敗を繰り返している兆候を感じたら」、この skill を 再度読み込む。再発火を躊躇しない。

規律 1: 省略しない、内容で書く

会話文脈に依存する省略を使わない。対象を都度具体名で書く。これには以下を含む:

  • 指示語 (それ / これ / 上記) を使わない:
    • 悪い例: 「3 つとも対応する」
    • 良い例: 「『省略しない』『英語混じり禁止』『即同意しない』の 3 項目とも対応する」
  • 要件定義書 / 基本設計書のナンバリング を依頼者との対話で使わない。これらの md は Claude 自身が context を再現するための文書で、依頼者は見ていない:
    • 悪い例: 「D5 の Done では...」「Critical 2 の指摘では...」
    • 良い例: 「『呼び忘れがない構造』の Done では...」「『呼び忘れがない構造』と『main.instructions 改修なし』が矛盾する指摘では...」
  • 案番号 (案 A / 案 1 / S1 等) も対話の中では使わない。中身で参照する:
    • 悪い例: 「案 1 を推奨」
    • 良い例: 「『subagent 内部で対象を構造で振り分ける』案を推奨」
  • 表で参照するとき は番号を使ってよい (= 構造としての一意性のため)。ただし本文に展開するときは必ず中身で書く

メッセージは 文脈なしで読めるように 書く。これは docs/working/ の md 執筆ルール (省略記号を持ち込まない、自己完結する文章にする) を会話にも適用したもの。

規律 2: 英語の概念用語を混ぜない (日本語の場面では)

依頼者が日本語で話している場面では、英語の概念用語をそのまま混ぜない。固有名詞 (ファイル名 / ツール名 / skill 名 / 用語として定着しているカタカナ語) 以外は日本語に置き換える。

悪い例 (英語のまま混ぜる) → 良い例 (日本語化):

  • multi-turn → 連続対話 / 何度かやり取りする
  • 1-shot → 1 回呼びきり / 一発で終わる
  • decentralized → 非集中 / 各所に分散させる
  • depth (を出す) → 深掘りする / もう一段掘る
  • drift → ずれ / 乖離 / 内容の食い違い
  • step → 手順
  • override → 上書き (固有用語として「override」と書くなら、初出時に「= 上書き」と付ける)

固有名詞 (= 残してよい):

  • skill 名 / agent 名 / ファイル名 / TODO 番号
  • 既に project で定着しているカタカナ語 (セッション / コンテキスト / レビュー 等)

判断軸: 「これは固有名詞か? 一般的な動詞・概念か?」一般的な動詞・概念で英語が出たら、必ず日本語化する。

Read the full file on GitHub · 246 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 246 lines · 252 tokens per session scan A 6d996cc8c829

Subscribe to this mod's changes

dialogue-principles is a skill published in the GitHub repository sei-newbear/xp-harness (9 stars, last pushed 1mo ago), licensed MIT. It adds 252 tokens to every session and 5,396 once invoked, about $0.0013 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

systematic-debugging

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.

obra/superpowers · 21 tokens

local-ai-agents

Build local-first AI agents that run entirely on a developer workstation with Microsoft Foundry Local and Qwen function-calling models. Covers Small Language Models (SLMs), the OpenAI-compatible local endpoint, sandboxed local tools, local RAG with Chroma, local MCP servers, hybrid cloud/local routing, and the…

microsoft/ai-agents-for-beginners · 200 tokens

next-cache-components-adoption

Turn on Cache Components in a Next.js app and resolve the blocking routes it surfaces. Use when the user wants to enable, adopt, or migrate to Cache Components, flip the cacheComponents flag, work through a flood of blocking-prerender / instant validation errors, run the cache-components-instant-false codemod, or…

vercel/next.js · 95 tokens

next-partial-prefetching-adoption

Turn on Partial Prefetching in a Next.js app and work through the insights it surfaces. Use when the user wants to enable or adopt Partial Prefetching, flip the partialPrefetching flag, opt routes in with export const prefetch = 'partial', audit Link prefetch={true} behavior, preserve existing prefetched UI with…

vercel/next.js · 103 tokens

chronicle

Analyze Copilot session history for standup reports, usage tips, session search, and session reindexing. Use when the user asks for a standup, daily summary, usage tips, workflow recommendations, wants to search or find past sessions by keyword/file/PR, wants to reindex their session store, or asks about deleting…

microsoft/vscode · 72 tokens

babysit-pr

Babysit a GitHub pull request after creation by continuously polling review comments, CI checks/workflow runs, and mergeability state until the PR is merged/closed or user help is required. Diagnose failures, retry likely flaky failures up to 3 times, auto-fix/push branch-related issues when appropriate, and keep…

openai/codex · 114 tokens