Agent skill

Rdd Defect Workflow

by Gentleman-Programming in Gentleman-Programming/gentle-ai

Trigger: RDD, receipt-driven development, review authority, receipt/lineage, correction/recovery, delivery gate/kill switch, bounded review defects.

Apache-2.0Auto-check passed

Install Rdd Defect Workflow

skills CLI
$ npx skills add Gentleman-Programming/gentle-ai --skill rdd-defect-workflow -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Gentleman-Programming/gentle-ai rdd-defect-workflow --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Gentleman-Programming/gentle-ai.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/rdd-defect-workflow .claude/skills/rdd-defect-workflow && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
rdd-defect-workflow
GitHub stars
7.6k
Token cost
~934 tokens
SKILL.md length
437 words
Files
1
Skills in repo
15
Repo updated
First seen
Licence
Apache-2.0

At a glance

Trigger: RDD, receipt-driven development, review authority, receipt/lineage, correction/recovery, delivery gate/kill switch, bounded review defects.

  • Works in 5 steps: Check mode, approval, PR conflicts, and… → Name invariant and rollback; isolate the… → Inventory flows and controls; add… → …
  • SKILL.md covers Activation Contract, Hard Rules, Decision Gates and Execution Steps, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Rdd Defect Workflow is an agent skill from Gentleman-Programming/gentle-ai. Trigger: RDD, receipt-driven development, review authority, receipt/lineage, correction/recovery, delivery gate/kill switch, bounded review defects. Guide work.

Its SKILL.md is about 930 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Gentle-AI configures the AI coding agents you already use: Claude Code, Cursor, OpenCode, Codex, Pi, and more. Choose persistent memory, Organic-Driven Development, curated… The licence is Apache-2.0.

Example prompts

  • “/rdd-defect-workflow”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Check mode, approval, PR conflicts, and current-main reproduction.
  2. Name invariant and rollback; isolate the worktree; CodeGraph-map code, tests, evidence, docs, distribution, and registration.
  3. Inventory flows and controls; add failing tests and the smallest correction.
  4. Normalize, enforce budget, run tests, and record each flow's exact candidate, command, scenario, and result.
  5. Freeze, validate read-only, and give the verdict, evidence, and one humane next action.

What it can do on your machine

Read from SKILL.md and the folder at commit 81d2225. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Rdd Defect Workflow loads about 934 tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 437 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~45
When it runs · the whole SKILL.md, loaded when a task matches
~934

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Gentleman-Programming/gentle-ai at commit 81d2225, republished under its Apache-2.0 licence (© Gentleman-Programming). 437 words, ~934 tokens.

Download SKILL.mdSave it as .claude/skills/rdd-defect-workflow/SKILL.md (or your agent's skills folder).
name
rdd-defect-workflow
description
Trigger: RDD, receipt-driven development, review authority, receipt/lineage, correction/recovery, delivery gate/kill switch, bounded review defects. Guide work.
license
Apache-2.0
metadata.author
gentleman-programming
metadata.version
1.0

Activation Contract

Load when the frontmatter trigger terms apply to a defect workflow.

This skill guides public collaboration. It does not grant issue approval, label, review, exception, or merge authority.

Hard Rules

  • Check the user-owned RDD kill switch first. When disabled, do not start receipt reviews or fabricate approval; follow ordinary policy and report disabled/unmanaged.
  • Require an approved issue (status:approved) and clean current main reproduction before implementation. Audit existing PRs for supersession or conflict; stop or narrow stale claims.
  • Group by causal authority invariant. Use one issue and one PR or explicit chain per independent invariant and rollback boundary. Split independent causes; never merge a superseded or conflicting authority line.
  • Inventory every operator flow claimed by the issue or PR, including entry, mode, environment, expectation, and negative controls. Require one truthful black-box bench journey per CLI or lifecycle flow, or actual runtime E2E proof when the core bench cannot represent it. Synthetic proxy coverage never proves another runtime.
  • Use CodeGraph-first impact mapping, a dedicated worktree, and behavior-first tests. Run source-mutating normalization before candidate freeze.
  • Forecast authored changes before edits. The hard limit is 400 additions plus deletions; above it, STOP for a chain or explicit maintainer-approved exception.
  • Only when RDD is enabled, bind the review candidate identity, lineage, correction, and recovery records exactly. Keep bounded review defects in one correction transaction; ordinary repository policy decides delivery.
  • Require independent read-only candidate validation before publication. Validation cannot edit source or authority; findings require a new candidate.
  • Keep communication humane and evidence-based. Repository labels and workflow metadata are maintainer-owned, never evidence of contributor blame.
Show full SKILL.md (176 more words)Show less

Decision Gates

ConditionAction
RDD disabledOrdinary policy; disabled/unmanaged; no receipt or approval claim.
Issue gate or reproduction failsWait, stop, or narrow with evidence.
Invariant or rollback is independentSeparate issue and authoritative PR line.
Core bench fits / does not fitBench journey / actual runtime E2E; never proxy.
Forecast exceeds 400 linesChain or approved exception before edits.

Execution Steps

  1. Check mode, approval, PR conflicts, and current-main reproduction.
  2. Name invariant and rollback; isolate the worktree; CodeGraph-map code, tests, evidence, docs, distribution, and registration.
  3. Inventory flows and controls; add failing tests and the smallest correction.
  4. Normalize, enforce budget, run tests, and record each flow's exact candidate, command, scenario, and result.
  5. Freeze, validate read-only, and give the verdict, evidence, and one humane next action.

Output Contract

Return rdd_mode, issue_pr, causal_invariant, operator_flows, journey_runtime_evidence, changed_line_budget, tests, rollback, and unresolved_authority_decisions.

Identify approved and superseded/conflicting authority lines; every flow, negative control, and candidate-bound proof; additions plus deletions and chain/exception; test results; independent rollback; and unresolved maintainer decisions.

References

No supporting files. Current repository policy remains authoritative.

© Gentleman-Programming, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/rdd-defect-workflow of Gentleman-Programming/gentle-ai.

Open the folder on GitHubat commit 81d2225

Compare with similar skills

Rdd Defect Workflow next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Rdd Defect Workflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Rdd Defect Workflow this skillGentleman-Programming/gentle-ai7.6k—~934Automated safety check: PassApache-2.0
Gentle AI Rdd Defect WorkflowGentleman-Programming/gentle-shell1.2k—~955Automated safety check: PassApache-2.0
Hermes Agent Skill AuthoringNousResearch/hermes-agent252k—~3.6kAutomated safety check: PassMIT
Configuring Oauth2 Authorization Flowmukul975/Anthropic-Cybersecurity-Skills34k—~1.7kAutomated safety check: PassApache-2.0
Bug Receiptgithub/awesome-copilot40k—~1.1kAutomated safety check: PassMIT
Implementing GCP Binary Authorizationmukul975/Anthropic-Cybersecurity-Skills34k—~2kAutomated safety check: PassApache-2.0

Similar skills

  • Gentle AI Rdd Defect Workflow

    Gentleman-Programming/gentle-shell

    Trigger: RDD, receipt-driven development, review authority, receipt/lineage, correction/recovery, delivery gate/kill switch, bounded review defects.

    1.2k GitHub stars~955 tokensUpdated today
    Testing & QAAuto-check passed
  • Hermes Agent Skill Authoring

    NousResearch/hermes-agent

    Author in-repo SKILL.md files: frontmatter and structure. An agent skill from NousResearch/hermes-agent.

    252k GitHub stars~3.6k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Configuring Oauth2 Authorization Flow

    mukul975/Anthropic-Cybersecurity-Skills

    Configures secure OAuth 2.0 authorization flows, including Authorization Code with PKCE, Client Credentials, and Device Authorization Grant, covering flow selection, PKCE implementation, token…

    34k GitHub stars~1.7k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Bug Receipt

    github/awesome-copilot

    Official

    Close defects and incidents with a BUG RECEIPT and VERIFIED, PARTIAL, or BLOCKED status after diagnosis, repair, or recovery.

    40k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Implementing GCP Binary Authorization

    mukul975/Anthropic-Cybersecurity-Skills

    Implements GCP Binary Authorization end to end, including creating KMS-backed attestors, Container Analysis notes, deploy-time policies, and signing image attestations, so that only trusted…

    34k GitHub stars~2k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check passed
  • Collectors Authoring

    netdata/netdata

    Author, modify, or review Netdata collectors across Go, IBM, C, Rust and external plugins.

    81k GitHub stars~1.9k tokensUpdated today
    DevOps & CloudAuto-check passed

More from Gentleman-Programming/gentle-ai

All 15 skills in this repo
  • GitHub Issue Creation

    Gentleman-Programming/gentle-ai

    Drafts, creates, comments on and approves GitHub issues under strict rules: YAML Issue Forms, a duplicate search first, and guarded protected labels.

    7.6k GitHub stars~3.3k tokensUpdated today
    Auto-check passed
  • Skill Creator

    Gentleman-Programming/gentle-ai

    Guides writing a new agent skill: when one is warranted, the required folder layout and frontmatter, section order and size limits, with a bundled style guide.

    7.6k GitHub stars~998 tokensUpdated today
    Auto-check passed
  • Gentle AI Pull Requests

    Gentleman-Programming/gentle-ai

    Prepares pull requests for the Gentle AI project under an issue-first rule: a linked approved issue, one type label, a valid branch name and confirmed required CI.

    7.6k GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Work-Unit Commits

    Gentleman-Programming/gentle-ai

    Plans commits and PRs as reviewable work units, keeping tests and docs with the code they cover and splitting large changes into chained PRs.

    7.6k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Go Testing

    Gentleman-Programming/gentle-ai

    Trigger: Go tests, go test coverage, Bubbletea teatest, golden files.

    7.6k GitHub stars~550 tokensUpdated today
    Auto-check passed
  • Hermes Ephemeral Delegation

    Gentleman-Programming/gentle-ai

    Trigger: a mapping need, parallel units, context backstop, high-risk verify, fresh review, or multi-step debug.

    7.6k GitHub stars~1.1k tokensUpdated today
    Auto-check passed

Questions about Rdd Defect Workflow

What does Rdd Defect Workflow do?

Trigger: RDD, receipt-driven development, review authority, receipt/lineage, correction/recovery, delivery gate/kill switch, bounded review defects. Rdd Defect Workflow is an agent skill from Gentleman-Programming/gentle-ai. Trigger: RDD, receipt-driven development, review authority, receipt/lineage, correction/recovery, delivery gate/kill switch, bounded review defects.

How do I install Rdd Defect Workflow in Claude Code?

Run `npx skills add Gentleman-Programming/gentle-ai --skill rdd-defect-workflow -a claude-code`. Or copy the skill folder (skills/rdd-defect-workflow in Gentleman-Programming/gentle-ai) into .claude/skills/rdd-defect-workflow in your project. Claude Code loads it when a task matches its description.

How do I install Rdd Defect Workflow in Codex?

Run `npx skills add Gentleman-Programming/gentle-ai --skill rdd-defect-workflow -a codex`. Or copy the skill folder (skills/rdd-defect-workflow in Gentleman-Programming/gentle-ai) into .agents/skills/rdd-defect-workflow in your project. Codex loads it when a task matches its description.

Can I use Rdd Defect Workflow in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Gentleman-Programming/gentle-ai --skill rdd-defect-workflow -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/rdd-defect-workflow, .gemini/skills/rdd-defect-workflow, .github/skills/rdd-defect-workflow and .opencode/skills/rdd-defect-workflow in your project.

What does Rdd Defect Workflow need to run?

SKILL.md names no scripts, command-line tools or credentials: Rdd Defect Workflow is instructions for the agent only.

Does Rdd Defect Workflow access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Rdd Defect Workflow safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Rdd Defect Workflow use?

Rdd Defect Workflow is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Rdd Defect Workflow use?

About 934 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Rdd Defect Workflow?

Skills that share tags, products or a category with Rdd Defect Workflow: Gentle AI Rdd Defect Workflow (Gentleman-Programming/gentle-shell, 1.2k stars), Hermes Agent Skill Authoring (NousResearch/hermes-agent, 252k stars), Configuring Oauth2 Authorization Flow (mukul975/Anthropic-Cybersecurity-Skills, 34k stars) and Bug Receipt (github/awesome-copilot, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Rdd Defect Workflow?

Gentleman-Programming (a GitHub organization) maintains it in Gentleman-Programming/gentle-ai, which has 7,583 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on October 7, 2026.

Source: Gentleman-Programming/gentle-ai on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.