Not in the top 1,000 by GitHub stars

HKUST-KnowComp/DeepRefine-Skill

An agent skill to evolve the quality of LLM-Wiki (Graphify) at test time.

History

Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.

View weekly changes

SKILL.md

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Local scripts

First observation → 9b17e7c086af

No earlier version was observed for comparison.

Compare on GitHub

deeprefine_skill/SKILL.md

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Network or broad shell

First observation → 9b17e7c086af

No earlier version was observed for comparison.

Compare on GitHub

deeprefine_skill/claude_skill/SKILL.md

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Instructions only

First observation → 9b17e7c086af

No earlier version was observed for comparison.

Compare on GitHub

deeprefine_skill/codex_skill/SKILL.md

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Instructions only

First observation → 9b17e7c086af

No earlier version was observed for comparison.

Compare on GitHub

deeprefine_skill/dsh_skill/SKILL.md

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Instructions only

First observation → 9b17e7c086af

No earlier version was observed for comparison.

Compare on GitHub

deeprefine_skill/gemini_extension/skills/deeprefine/SKILL.md

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Instructions only

First observation → 9b17e7c086af

No earlier version was observed for comparison.

Compare on GitHub

skills/deeprefine/SKILL.md

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Instructions only

First observation → 9b17e7c086af

No earlier version was observed for comparison.

Compare on GitHub

View on GitHubAdd to my skills

Verified commit 9b17e7c086af8fd30b023868b1e96ae3295b8f04

git clone --filter=blob:none --no-checkout https://github.com/HKUST-KnowComp/DeepRefine-Skill.git .hotskills/hkust-knowcomp-deeprefine-skill && git -C .hotskills/hkust-knowcomp-deeprefine-skill checkout --detach 9b17e7c086af8fd30b023868b1e96ae3295b8f04 # Copy each selected skill directory from .hotskills/hkust-knowcomp-deeprefine-skill into .gemini/skills/<skill-name>/
90GitHub stars
-1star in 7 days
7skills in this repository
0commits in 30 days

Heat

0.2
  • Star growth, last 7 daysNot available
  • Star growth, last 24 hoursNot available
  • Rank movement, last 7 daysNot available
  • Commits, last 30 daysNot available
  • Accounts asking about it through MCP, last 7 daysNot available
  • Hot votes this weekNot available

Heat never changes the order by stars, and sponsorship never touches it. How heat works

Stars over time

Oct 25, 2026Nov 3, 202691

30-day change not yet available: not enough history.

Individual skills in this repository

How it works

deeprefine

When your agent uses it

Agent-native DeepRefine refinement loop — same control flow as DeepRefine.refine(), graphify search instead of FAISS, session LLM, dry-run review before approved graph writes.

What it loads into context

Frontmatter

57 tokens

Always available to the agent

SKILL.md

4,072 tokens

When the skill is activated

Reference documents

17,713 tokens

Loaded on request

Token counts are estimates. Scripts run separately; they are not counted as reference context.

The playbook

  1. Default safety policy: dry-run only
  2. FORBIDDEN (hard stop)
  3. Constants (match `refine_runner.py` / DeepRefine)
  4. Mandatory artifact
  5. Query queue selection (default behavior of `/deeprefine`)
  6. Control flow (must match `DeepRefine.refine()`)
  7. Evidence-aware review rules
  8. LLM prompts (verbatim — do not paraphrase)
  9. Per-query checklist (report in chat)
  10. Commands (in order)
  11. `loop_trace_*.json` schema
  12. Optional: CLI mode (FAISS + API)
  13. Paths

Scripts executed separately

  • eval/benchmarks/kg_structure.py
  • eval/benchmarks/refinement_recall.py
  • scripts/deeprefine.py
  • scripts/validate_graph_schema.py
  • tests/test_dsh_integration.py
  • tests/test_opencode_integration.py
  • tests/test_wiki_refresh.py

Files

  • .gitignoreasset603 bytes
  • GEMINI.mddoc1,641 bytes
  • LICENSEasset1,071 bytes
  • MANIFEST.inasset501 bytes
  • README.mddoc24,223 bytes
  • SKILL.mdcore16,592 bytes
  • SKILL.mdcore16,592 bytes
  • SKILL.mdcore16,592 bytes
  • SKILL.mdcore16,592 bytes
  • SKILL.mdcore16,592 bytes
  • SKILL.mdcore16,592 bytes
  • SKILL.mdcore16,592 bytes
  • SKILL.mdcore16,592 bytes
  • assets/claudecode-color.pngasset1,467 bytes
  • assets/codex-color.pngasset7,578 bytes
  • assets/cursor_CUBE_25D.pngasset62,709 bytes
  • assets/demo-typing-deeprefine.svgasset6,643 bytes
  • assets/gemini-cli-icon_full-color@4x.pngasset866,495 bytes
  • assets/github-copilot__1_-removebg-preview.pngasset217,080 bytes
  • assets/harness.pngasset86,687 bytes
  • assets/icons.pngasset1,452,478 bytes
  • assets/icons2.pngasset269,804 bytes
  • assets/icons3.pngasset99,043 bytes
  • assets/opencode-logo-dark.pngasset2,491 bytes
  • assets/opencode-wordmark-dark.pngasset2,837 bytes
  • commands/deeprefine.tomlasset1,744 bytes
  • commands/deeprefine/apply.tomlasset1,289 bytes
  • commands/deeprefine/review.tomlasset1,373 bytes
  • docs/codex.mddoc2,537 bytes
  • docs/copilot-cli.mddoc3,705 bytes
  • docs/dsh.mddoc1,968 bytes
  • docs/feat-verification-fixtures.mddoc7,958 bytes
  • docs/gemini-cli.mddoc2,068 bytes
  • docs/phase-b-report.mddoc6,343 bytes
  • docs/verification-data.mddoc6,837 bytes
  • eval/README.mddoc7,494 bytes
  • eval/benchmarks/kg_structure.pyruns6,139 bytes
  • eval/benchmarks/refinement_recall.pyruns7,724 bytes
  • eval/smoke-tests/README.mddoc3,202 bytes
  • fixtures/refinement-ambiguous.txtdoc74 bytes
  • fixtures/refinement-good.txtdoc78 bytes
  • fixtures/refinement-invalid.txtdoc67 bytes
  • fixtures/synth-minimal.jsonasset5,042 bytes
  • fixtures/trace-invalid-order.jsonasset1,419 bytes
  • fixtures/trace-valid-early-exit.jsonasset1,098 bytes
  • fixtures/trace-valid.jsonasset2,908 bytes
  • gemini-extension.jsonasset252 bytes
  • pyproject.tomlasset2,114 bytes
  • scripts/deeprefine.pyruns429 bytes
  • scripts/validate_graph_schema.pyruns4,698 bytes
  • tests/test_dsh_integration.pyruns9,166 bytes
  • tests/test_opencode_integration.pyruns10,140 bytes
  • tests/test_wiki_refresh.pyruns13,424 bytes
Read SKILL.md

# DeepRefine — Agent refinement loop (strict)

## Default safety policy: dry-run only

A normal `/deeprefine` invocation **MUST NEVER** call `deeprefine apply`.

The default `/deeprefine` 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 the user for explicit approval.
View the complete source on GitHub

Skills included

  • deeprefine
  • deeprefine
  • deeprefine
  • deeprefine
  • deeprefine
  • deeprefine
  • deeprefine

Repository facts

License
MIT
Created
Jun 1, 2026
Last pushed
Aug 23, 2026
Forks
9
Open issues
1
Project activity
Slowing

Before you install

Network or broad shell

Automated signals, not a guarantee

Checked Nov 6, 2026

Not fully analyzed: some files were too long, unreadable or missing. This never lowers the level.

Show 55 notes
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • deeprefine_skill/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • deeprefine_skill/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • deeprefine_skill/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • deeprefine_skill/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • deeprefine_skill/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • deeprefine_skill/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • deeprefine_skill/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • deeprefine_skill/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • deeprefine_skill/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • deeprefine_skill/claude_skill/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • deeprefine_skill/claude_skill/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • deeprefine_skill/claude_skill/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • deeprefine_skill/claude_skill/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
Show all 72 signals by file

README.md

  • Network accessline 21
    [![PyPi](https://img.shields.io/badge/PyPi-v0.2.0-blue.svg)](https://pypi.org/project/deeprefine-cli/0.2.0/)
  • Network accessline 22
    [![Python](https://img.shields.io/badge/Python-3.10,3.11,3.12-blue.svg)](https://pypi.org/project/deeprefine-cli/0.2.0/)
  • Network accessline 23
    [![Paper](https://img.shields.io/badge/Paper-DeepRefine-b31b1b.svg)](https://arxiv.org/pdf/2605.10488)
  • Network accessline 24
    [![Project](https://img.shields.io/badge/Project-DeepRefine-green.svg)](https://github.com/HKUST-KnowComp/DeepRefine)
  • Network accessline 28
    DeepRefine-Skill plugs into agent workflows and use a single command `/deeprefine` in your agent (Cursor, Copilot CLI, Gemini CLI, Codex, OpenCode, Claude Code) to refine and evolve your LLM-Wiki (e.g., **[graphify](https://github.com/safis
  • Network accessline 38
    <p>   <a href="https://cursor.com" title="Cursor"><img src="./assets/cursor_CUBE_25D.png" alt="Cursor" height="40"/></a>&nbsp;&nbsp;
  • Network accessline 39
    <a href="https://cursor.com" title="Cursor"><img src="./assets/cursor_CUBE_25D.png" alt="Cursor" height="40"/></a>&nbsp;&nbsp;
  • Network accessline 40
    <a href="https://github.com/google-gemini/gemini-cli" title="Gemini CLI"><img src="./assets/gemini-cli-icon_full-color@4x.png" alt="Gemini CLI" height="40"/></a>&nbsp;&nbsp;
  • Network accessline 41
    <a href="https://docs.github.com/en/copilot" title="GitHub Copilot CLI" style="text-decoration: none; color: inherit;"><img src="./assets/github-copilot__1_-removebg-preview.png" height="40" style="vertical-align: middle;" alt="Copilot Icon
  • Network accessline 42
    <a href="https://openai.com/codex/" title="Codex CLI" style="text-decoration: none; color: inherit;"><img src="./assets/codex-color.png" height="40" style="vertical-align: middle;" alt="Copilot Icon" /></a>&nbsp;&nbsp;
  • Network accessline 43
    <a href="https://opencode.ai/" title="OpenCode" style="text-decoration: none; color: inherit;"><img src="./assets/opencode-logo-dark.png" height="40" style="vertical-align: middle;" alt="Copilot Icon" /></a>&nbsp;&nbsp;
  • Network accessline 44
    <a href="https://claude.com/product/claude-code" title="Claude Code" style="text-decoration: none; color: inherit;"><img src="./assets/claudecode-color.png" height="40" style="vertical-align: middle;" alt="Copilot Icon" /></a>&nbsp;&nbsp;
  • Access to secretsline 521
    [Credential-related source omitted]
  • Access to secretsline 522
    [Credential-related source omitted]
  • Access to secretsline 523
    [Credential-related source omitted]

assets/demo-typing-deeprefine.svg

  • Network accessline 1
    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 560 60" width="560" height="60">

deeprefine_skill/SKILL_COPILOT.md

deeprefine_skill/__init__.py

  • Executable scriptline 1
    Executable file

deeprefine_skill/action_review.py

  • Executable scriptline 1
    Executable file

deeprefine_skill/adapter_graphify.py

  • Executable scriptline 1
    Executable file

deeprefine_skill/agent_graph.py

  • Executable scriptline 1
    Executable file

deeprefine_skill/agent_loop.py

  • Executable scriptline 1
    Executable file

deeprefine_skill/agent_prompts.py

  • Executable scriptline 1
    Executable file

deeprefine_skill/cli.py

  • Executable scriptline 1
    Executable file

deeprefine_skill/history.py

  • Executable scriptline 1
    Executable file

deeprefine_skill/installers.py

  • Executable scriptline 1
    Executable file

deeprefine_skill/obsidian_refresh.py

  • Executable scriptline 1
    Executable file

deeprefine_skill/paths.py

  • Executable scriptline 1
    Executable file
  • Access to secretsline 23
    [Credential-related source omitted]
  • Access to secretsline 176
    [Credential-related source omitted]
  • Access to secretsline 177
    [Credential-related source omitted]
  • Access to secretsline 181
    [Credential-related source omitted]
  • Access to secretsline 182
    [Credential-related source omitted]
  • Access to secretsline 183
    [Credential-related source omitted]
  • Access to secretsline 184
    [Credential-related source omitted]
  • Access to secretsline 186
    [Credential-related source omitted]
  • Access to secretsline 187
    [Credential-related source omitted]
  • Access to secretsline 189
    [Credential-related source omitted]
  • Access to secretsline 192
    [Credential-related source omitted]

deeprefine_skill/refine_runner.py

  • Executable scriptline 1
    Executable file
  • Access to secretsline 65
    [Credential-related source omitted]
  • Access to secretsline 69
    [Credential-related source omitted]
  • Access to secretsline 70
    [Credential-related source omitted]
  • Access to secretsline 71
    [Credential-related source omitted]
  • Access to secretsline 73
    [Credential-related source omitted]
  • Access to secretsline 80
    [Credential-related source omitted]
  • Access to secretsline 84
    [Credential-related source omitted]

deeprefine_skill/wiki_importer.py

  • Executable scriptline 1
    Executable file

deeprefine_skill/wiki_refresh.py

  • Executable scriptline 1
    Executable file
  • Access to secretsline 238
    [Credential-related source omitted]

deeprefine_skill/wiki_retrieval.py

  • Executable scriptline 1
    Executable file

deeprefine_skill/wiki_update.py

  • Executable scriptline 1
    Executable file

docs/feat-verification-fixtures.md

  • Dangerous shell operationline 135
    rm -rf /tmp/test_kb

docs/verification-data.md

  • Dangerous shell operationline 143
    rm -rf /tmp/test_kb

eval/README.md

  • Access to secretsline 91
    [Credential-related source omitted]

eval/benchmarks/kg_structure.py

  • Executable scriptline 1
    #!/usr/bin/env python3

eval/benchmarks/refinement_recall.py

  • Executable scriptline 1
    #!/usr/bin/env python3
  • Access to secretsline 102
    [Credential-related source omitted]
  • Access to secretsline 203
    [Credential-related source omitted]
  • Access to secretsline 204
    [Credential-related source omitted]
  • Access to secretsline 212
    [Credential-related source omitted]

pyproject.toml

  • Network accessline 31
    [project.urls] Homepage = "https://github.com/HKUST-KnowComp/DeepRefine-Skill"
  • Network accessline 32
    Homepage = "https://github.com/HKUST-KnowComp/DeepRefine-Skill"
  • Network accessline 33
    Documentation = "https://github.com/HKUST-KnowComp/DeepRefine-Skill#readme"
  • Network accessline 34
    Repository = "https://github.com/HKUST-KnowComp/DeepRefine-Skill"
  • Network accessline 35
    Issues = "https://github.com/HKUST-KnowComp/DeepRefine-Skill/issues"

scripts/deeprefine.py

  • Executable scriptline 1
    #!/usr/bin/env python3

scripts/validate_graph_schema.py

  • Executable scriptline 1
    #!/usr/bin/env python3

tests/test_dsh_integration.py

  • Executable scriptline 1
    Executable file

tests/test_opencode_integration.py

  • Executable scriptline 1
    Executable file
  • Access to secretsline 50
    [Credential-related source omitted]

tests/test_wiki_refresh.py

  • Executable scriptline 1
    Executable file

How the signals fit together

Facts from a static read of the files at the pinned commit. They describe what the code does, not why.

Some files could not be read; the facts below still hold.

Signal confidence: 66 facts

and 16 more

Works with

Agent compatibility, from the files in this repository
AgentStatusEvidenceInstall to
Claude CodeNativeFrontmatter field disable-model-invocation in SKILL.md.claude/skills/<skill-name>/
CodexCompatibleStandard SKILL.md SKILL.md.agents/skills/<skill-name>/
CursorCompatibleStandard SKILL.md SKILL.md.cursor/skills/<skill-name>/
Gemini CLINativeManifest deeprefine_skill/gemini_extension/gemini-extension.json.gemini/skills/<skill-name>/
GitHub CopilotCompatibleStandard SKILL.md SKILL.md.github/skills/<skill-name>/
OpenCodeCompatibleStandard SKILL.md SKILL.md.opencode/skills/<skill-name>/
  • Native The repository ships a manifest, folder or frontmatter field for this agent.
  • Compatible A standard SKILL.md that this agent can read.
  • Unknown No evidence either way.

Derived automatically from paths, manifests and frontmatter. Not tested on each agent.