# Deeprefine > >- - **Type:** Skill - **Install:** `agentstack add skill-hkust-knowcomp-deeprefine-skill-codex-skill` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [HKUST-KnowComp](https://agentstack.voostack.com/s/hkust-knowcomp) - **Installs:** 0 - **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [HKUST-KnowComp](https://github.com/HKUST-KnowComp) - **Source:** https://github.com/HKUST-KnowComp/DeepRefine-Skill/tree/main/deeprefine_skill/codex_skill - **Website:** https://hhy-huang.github.io/DeepRefine_page/ ## Install ```sh agentstack add skill-hkust-knowcomp-deeprefine-skill-codex-skill ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # DeepRefine - Codex Adapter This file is the Codex-specific entrypoint. It keeps the platform rules small and loads longer DeepRefine procedure details only when needed: - Full workflow, queue selection, Reafiner branch logic, and review rules: [references/reafiner-workflow.md](references/reafiner-workflow.md) - Verbatim judgement, abduction, and refinement prompts: [references/llm-prompts.md](references/llm-prompts.md) - Checklist, command sequence, trace schema, paths, and CLI mode: [references/trace-and-commands.md](references/trace-and-commands.md) Do not reimplement or shorten the algorithm from memory. Load the relevant reference file before executing that part of the workflow. ## Codex Invocation Trigger this skill when the user: - explicitly invokes `$deeprefine` or `/deeprefine`; - asks to refine, improve, diagnose, repair, inspect, or review a Graphify knowledge graph; - asks to apply a previously reviewed DeepRefine refinement. Run from the knowledge-base project root, where `graphify-out/graph.json` exists. If the user is planning or asking how DeepRefine works, explain the workflow and do not mutate files. If `deeprefine` is unavailable, tell the user to install it: ```bash pip install deeprefine-cli ``` For source development: ```bash pip install -e /path/to/DeepRefine-Skill ``` ## Hard Safety Policy A normal `$deeprefine` or `/deeprefine` invocation is dry-run only and **MUST NEVER** call `deeprefine apply`. The default workflow must stop after: 1. `deeprefine loop validate` 2. `deeprefine review` 3. showing the proposed actions and HIGH/MEDIUM/LOW review report to the user Then ask for explicit approval. Only if the user's next message explicitly says to approve/apply/write the graph may you run: ```bash deeprefine apply --trace-file ... --refinement-file ... deeprefine loop finish --trace-file ... --refinement-file ... ``` Do not treat any of these as approval: - generation of a `` block; - a valid `loop_trace_.json`; - a prior user message; - a successful `deeprefine review`. If the review contains LOW-confidence actions, use `--allow-low-confidence` only when the user's current approval message explicitly accepts that risk. ## Mode Selection ### Full workflow Use for `$deeprefine`, `/deeprefine`, or requests to refine/improve/fix the graph. Follow the canonical reference in this order: 1. `references/reafiner-workflow.md` 2. `references/llm-prompts.md` when producing tagged LLM outputs 3. `references/trace-and-commands.md` when writing traces or running commands Do not copy only the latest query if pending history exists. Process all unrefined history queries first, preserving canonical dedupe/order rules. ### Review only Use when the user asks to review, audit, inspect, dry-run, check evidence, or show what would change. Run validation and review only: ```bash deeprefine loop validate --trace-file ... --refinement-file ... deeprefine review --trace-file ... --refinement-file ... ``` Show the HIGH/MEDIUM/LOW evidence report. Do not modify `graph.json`. ### Apply only Use only when the user's current message explicitly approves a previously reviewed refinement. Before applying, verify that the trace and refinement file match `references/trace-and-commands.md` and the review rules in `references/reafiner-workflow.md`. Then run: ```bash deeprefine loop validate --trace-file ... --refinement-file ... deeprefine apply --trace-file ... --refinement-file ... deeprefine loop finish --trace-file ... --refinement-file ... ``` Use the LOW-confidence override only with explicit risk acknowledgement in the same user message: ```bash deeprefine apply --allow-low-confidence --trace-file ... --refinement-file ... ``` ## Non-Negotiable Rules These are restated here so Codex always sees the hard stops before loading any reference. Do not: 1. Run `deeprefine refine` unless the user explicitly asks for CLI/FAISS mode. 2. Call `deeprefine apply` without a valid `loop_trace_.json`. 3. Call `deeprefine apply` before `deeprefine review` and explicit approval. 4. Ignore LOW-confidence review warnings without explicit risk acceptance. 5. Skip any hop's `Yes` / `No` judgement. 6. Skip error abduction when `len(interaction_history) > 1`. 7. Write `` before abduction when refinement is required. 8. Hand-edit `graphify-out/graph.json` with Python or ad-hoc JSON patches. 9. Ignore pending history and refine only one latest query. 10. Invent a shorter pipeline such as "read file -> write refinement -> apply". If validation fails, fix the trace or rerun the missing step. Do not bypass with `--skip-trace-check` in agent mode. ## What to Load From References Keep this adapter concise. Load the smallest reference needed: - Full Reafiner pseudocode and safe review: `references/reafiner-workflow.md` - Verbatim LLM prompts: `references/llm-prompts.md` - Required JSON shape, exact command sequence, and CLI/FAISS exception path: `references/trace-and-commands.md` Use the canonical commands and artifacts exactly as written there. This adapter only maps those rules onto Codex's `$deeprefine` / `/deeprefine` invocation and approval behavior. ## Source & license This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [HKUST-KnowComp](https://github.com/HKUST-KnowComp) - **Source:** [HKUST-KnowComp/DeepRefine-Skill](https://github.com/HKUST-KnowComp/DeepRefine-Skill) - **License:** MIT - **Homepage:** https://hhy-huang.github.io/DeepRefine_page/ Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/skill-hkust-knowcomp-deeprefine-skill-codex-skill - Seller: https://agentstack.voostack.com/s/hkust-knowcomp - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.