codex-skills

Evidence-First Agent Skills

Portable agent skills distilled from real project work and maintained by

[oukeming64-tech](https://github.com/oukeming64-tech). The current collection

focuses on one boundary: an agent should not call work complete until its code,

evidence, documentation, release state, and stated scope agree.

Start here

| Your task | Use |

| --- | --- |

| Update docs after changing implementation | docs-sync-guardian |

| Check another agent's or contributor's claimed completion | handoff-auditor |

| Work in an existing docs-as-memory project | Let its doc-memory flow own retrieval and sealing; reuse that evidence |

Choose the owner that fits the task. A small edit does not need three complete pipelines or a new documentation index.

Skills

• handoff-auditor: audit implementation handoffs before accepting, merging, or declaring them complete. It checks claims against current code, verification evidence, docs, release state, and human acceptance requirements.
• docs-sync-guardian: keep repository documentation aligned with code, configuration, asset, release, workflow, or product changes. It treats docs as suspicious after changes, grounds updates in live implementation evidence, and uses a risk gate for human-judgment text.

Both skills are instruction-only. They add no MCP server, network client,

credential handling, telemetry, background service, or install hook.

DeepSeek Harness

This repository includes a community, Skill-only bundle for the DeepSeek

Harness developer preview. It is not an official DeepSeek product and does not

imply DeepSeek endorsement.

Compatibility target: @deepseek-ai/dsh@0.1.0-rc.6 with Node.js

^22.19.0 || >=24.0.0.

Install the tagged GitHub package into the Web profile:

dsh plugin --profile web add 'github:oukeming64-tech/codex-skills#dsh-v0.1.0'

Invoke either skill explicitly:

Use the handoff-auditor skill to verify this completion claim before accepting it.
Use the docs-sync-guardian skill to check this change for documentation drift.

Uninstall:

dsh plugin --profile web remove @oukeming64-tech/codex-skills

The integration only registers this repository's skills/ directory through

Harness's ordinary filesystem Skill provider. It does not add native tools or

change the default permission model.

Other Agent Runtimes

Copy a skill folder from skills/ into the runtime's user or project Skill

directory. For Codex, use ~/.codex/skills/ or a compatible .agents/skills/

location. For a Harness project-local installation, use .dsh/skills/.

Keep the folder name unchanged so it matches the name in SKILL.md.

Repository Validation

Run the fusion A/B coverage smoke check before claiming an absorbed skill update is complete:

python3 evals/fusion_ab_eval.py --old-ref 1d9949e --new-ref HEAD

To focus one skill:

python3 evals/fusion_ab_eval.py --old-ref 1d9949e --new-ref HEAD --skill docs-sync-guardian

This check catches missing fusion targets and baseline regressions. It does not replace independent review or scenario-based behavior testing.

The DeepSeek Harness package contract is checked separately:

node --test dsh/test/*.test.mjs

Ownership and Issues

• Author and maintainer: [oukeming64-tech](https://github.com/oukeming64-tech)
• Source: [oukeming64-tech/codex-skills](https://github.com/oukeming64-tech/codex-skills)
• Issues: [oukeming64-tech/codex-skills/issues](https://github.com/oukeming64-tech/codex-skills/issues)

Released under the [MIT License](LICENSE).