# Confident Language Guard

> Use when drafting or updating directives in docs (e.g., ROADMAP, AGENTS.md, CLAUDE.md, skills) as a gentle reminder to keep language cautious and flexible; avoid overly confident or absolute directives unless explicitly required.

- Skill: `majiayu000/confident-language-guard` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/confident-language-guard`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/confident-language-guard/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/confident-language-guard

---


# Confident Language Guard

## Goal

Keep documentation helpful without overstating certainty or locking in fragile guidance. This is a reminder, not an iron-clad rule.

## Core Rules

- Prefer scoped, time-bound statements ("in this phase", "for the current repo state").
- Replace absolutes ("always", "never", "must") with softer language unless a hard rule truly exists.
- Use qualifiers when the information could change ("appears", "likely", "based on current files").
- Separate **recommendations** from **requirements** and label them clearly.
- State assumptions when they affect the guidance.
- Avoid turning personal judgment into policy language.

## Allowed Absolutes (Exceptions)

- Use absolute language only when a requirement is explicit (e.g., system or repo rules).
- If a hard rule exists, cite the source or file when possible.

## Quick Checklist (Docs Pass)

- Does every directive have a clear source or rationale?
- Can any "always/never/must" be softened without losing meaning?
- Are assumptions stated and scoped?
- Are recommendations labeled as such?

## Example Rewrite

- Before: "You must always run full tests before every commit."
- After: "It is generally safer to run the full test suite before committing; skip only when time is constrained or the change is purely textual."

[Codex - 2026-01-12]