Skip to content
Back to search

SkillAdam

SkillAdam: Better Skills for Your AI Agent🚀 Claude Code/Codex/Cursor 插件,一键进化你的skill

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ruc-datalab--skilladam/badge.svg)](/listings/ruc-datalab--skilladam)

HTML

<a href="/listings/ruc-datalab--skilladam"><img src="/api/listings/ruc-datalab--skilladam/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Requirements

- **Python 3.10+**, with `pip` and `venv`, and **Git**. - Your chosen agent's CLI, installed, signed in, and available on your `PATH`: `codex`, `claude`, `cursor-agent`, or `copilot`. - For Copilot's default VS Code integration, the **`code` CLI** is also required. For Copilot CLI only, pass `--skip-vscode-registration` to its installer.

Cursor requires the **Cursor Agent CLI**; the desktop app alone is insufficient.

The default setup uses your existing agent sign-in and needs no local GPU, Docker, or separate model API key. Model calls consume your platform account's quota, and skill and task content is sent to the configured model provider.

Installation

Clone this repository:

git clone https://github.com/ruc-datalab/SkillAdam.git
cd SkillAdam

Run **one** installer for your platform from the repository root:

| Platform | macOS / Linux | |---|---| | Codex | `./integrations/codex/install.sh` | | Claude Code | `./integrations/claude-code/install.sh` | | Cursor Agent | `./integrations/cursor/install.sh` | | GitHub Copilot | `./integrations/github-copilot/install.sh` |

<details> <summary>Windows PowerShell</summary>

| Platform | Command | |---|---| | Codex | `.\integrations\codex\install.ps1` | | Claude Code | `.\integrations\claude-code\install.ps1` | | Cursor Agent | `.\integrations\cursor\install.ps1` | | GitHub Copilot | `.\integrations\github-copilot\install.ps1` |

</details>

The installer sets up a dedicated Python environment and registers SkillAdam with your agent. Restart your agent after installation; in VS Code, use **Developer: Reload Window**.

For more installation options, see the [platform guide](integrations/README.md#one-step-installation).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 168 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="assets/logo-readme.svg" alt="SkillAdam" width="480">
  3. </p>
  4. # SkillAdam: Better Skills for Your AI Agent
  5. [![arXiv](https://img.shields.io/badge/arXiv-2609.08944-b31b1b.svg)](https://arxiv.org/abs/2609.08944)
  6. [![Python](https://img.shields.io/badge/Python-3.10%2B-blue.svg)](pyproject.toml)
  7. [![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
  8. [![Code Stars](https://img.shields.io/github/stars/ruc-datalab/SkillAdam?style=social&label=Code%20Stars)](https://github.com/ruc-datalab/SkillAdam)
  9. [![wecom](https://img.shields.io/badge/WeCom-%E5%8A%A0%E5%85%A5Data%2BAI%E4%BA%A4%E6%B5%81%E7%BE%A4-black?logo=wechat&logoColor=07C160)](./assets/wecom.jpg)
  10. **Give SkillAdam a skill and tell it what you want to improve.** It tests your `SKILL.md` on relevant tasks, learns from the results, and checks proposed changes before updating the file.
  11. **Supported platforms: Codex · Claude Code · Cursor Agent · GitHub Copilot.**
  12. - **Improve skills for your workflow.** Describe your goal and provide examples of tasks your skill should handle.
  13. - **Learn from earlier attempts.** Use feedback from previous revisions to guide the next improvement and address recurring mistakes.
  14. - **Make measured changes.** Adapt the scope of each revision and keep changes that pass evaluation.
  15. - **Stay in your preferred agent.** Start an optimization in the agent you already use, with the option to review individual edits.
  16. <p align="center">
  17. <a href="assets/skilladam-framework.pdf">
  18. <img src="assets/skilladam-framework.png" alt="SkillAdam framework: task rollouts, optimization memory and adaptive edits, followed by skill updates." width="900">
  19. </a>
  20. </p>
  21. <p align="center">
  22. <a href="#demo">Demo</a> ·
  23. <a href="#quick-start">Quick Start</a> ·
  24. <a href="#usage">Usage</a> ·
  25. <a href="#citation">Citation</a>
  26. </p>
  27. ## News
  28. - **[2026.09.08]** Our paper, [SkillAdam: Stable and Efficient Skill Evolution for Agents](https://arxiv.org/abs/2609.08944), is now available on arXiv.
  29. - **[2026.09]** SkillAdam is released with integrations for Codex, Claude Code, Cursor Agent, and GitHub Copilot.
  30. ## Demo
  31. https://github.com/user-attachments/assets/a15049ee-90b5-4cda-a270-7628a60f76ed
  32. ## Quick Start
  33. ### Requirements
  34. - **Python 3.10+**, with `pip` and `venv`, and **Git**.
  35. - Your chosen agent's CLI, installed, signed in, and available on your `PATH`: `codex`, `claude`, `cursor-agent`, or `copilot`.
  36. - For Copilot's default VS Code integration, the **`code` CLI** is also required. For Copilot CLI only, pass `--skip-vscode-registration` to its installer.
  37. Cursor requires the **Cursor Agent CLI**; the desktop app alone is insufficient.
  38. The default setup uses your existing agent sign-in and needs no local GPU, Docker, or separate model API key. Model calls consume your platform account's quota, and skill and task content is sent to the configured model provider.
  39. ### Installation
  40. Clone this repository:
  41. ```bash
  42. git clone https://github.com/ruc-datalab/SkillAdam.git
  43. cd SkillAdam
  44. ```
  45. Run **one** installer for your platform from the repository root:
  46. | Platform | macOS / Linux |
  47. |---|---|
  48. | Codex | `./integrations/codex/install.sh` |
  49. | Claude Code | `./integrations/claude-code/install.sh` |
  50. | Cursor Agent | `./integrations/cursor/install.sh` |
  51. | GitHub Copilot | `./integrations/github-copilot/install.sh` |
  52. <details>
  53. <summary>Windows PowerShell</summary>
  54. | Platform | Command |
  55. |---|---|
  56. | Codex | `.\integrations\codex\install.ps1` |
  57. | Claude Code | `.\integrations\claude-code\install.ps1` |
  58. | Cursor Agent | `.\integrations\cursor\install.ps1` |
  59. | GitHub Copilot | `.\integrations\github-copilot\install.ps1` |
  60. </details>
  61. The installer sets up a dedicated Python environment and registers SkillAdam with your agent. Restart your agent after installation; in VS Code, use **Developer: Reload Window**.
  62. For more installation options, see the [platform guide](integrations/README.md#one-step-installation).
  63. ## Usage
  64. ### Improve Your Skill
  65. Open the workspace containing your skill and select **`skilladam-optimize`** through your agent's skill picker or invocation mechanism. Give it the skill path and your goal:
  66. ```text
  67. Use SkillAdam to optimize /absolute/path/to/SKILL.md for writing concise,
  68. actionable code reviews that catch correctness issues and edge cases.
  69. ```
  70. Your agent prepares relevant tasks and scoring rules. SkillAdam tests the current skill, proposes changes, and evaluates the revised version. **By default, proposed edits are selected automatically; your skill file is updated only when the revised version passes validation.**
  71. You can make your request more specific by describing a recurring problem or including a task example:
  72. ```text
  73. This skill often produces long explanations without a clear recommendation.
  74. Focus on making each review comment identify the problem, explain its impact,
  75. and suggest a concrete fix.
  76. ```
  77. SkillAdam currently optimizes **one existing `SKILL.md` at a time**. Include any context needed to evaluate your examples: supporting skill resources and workspace files are not automatically available during test runs. See [task guidance](integrations/README.md#tasks-and-evaluation-signals) for details.
  78. ### Choose Which Changes to Apply
  79. To review proposed edits yourself, include this in your request:
  80. ```text
  81. Before applying changes, show me the proposed edits and let me choose.
  82. ```
  83. You can accept or reject individual edits. SkillAdam then validates the selected changes before updating your skill.
  84. ### Continue an Interrupted Run
  85. Ask your agent to resume using the same run directory:
  86. ```text
  87. Resume the SkillAdam optimization in /absolute/path/to/the/run-directory.
  88. ```
  89. Keep your skill in version control so you can review its history or undo changes.
  90. For benchmark experiments, follow the [reproduction guide](docs/reproducibility/main_results.md):
  91. use the formal backend configurations and pass strict preflight before real
  92. execution. Generic backend examples are for custom runs. Training and evaluation
  93. produce new results; no historical score table is used for comparison.
  94. ## Citation
  95. If you find SkillAdam useful, please cite our [paper](https://arxiv.org/abs/2609.08944):
  96. ```bibtex
  97. @misc{li2026skilladam,
  98. title={SkillAdam: Stable and Efficient Skill Evolution for Agents},
  99. author={Gaoyuan Li and Meihao Fan and Yizhe Liu and Shaolei Zhang and Ju Fan and Siyi Wang and Jiaheng Hou and Xudong Weng and Honghan Tian and Zang Li},
  100. year={2026},
  101. eprint={2609.08944},
  102. archivePrefix={arXiv},
  103. primaryClass={cs.AI},
  104. url={https://arxiv.org/abs/2609.08944}
  105. }
  106. ```
  107. ## License
  108. SkillAdam is released under the [MIT License](LICENSE). Copyright (C) 2026 Tencent. All rights reserved. Third-party attribution is preserved in [NOTICE](NOTICE).
  109. ## Misc
  110. Welcome to join the [Data+AI Enterprise WeChat group](./assets/wecom.jpg), chat and share ideas with other users.
  111. <p align="center" width="100%">
  112. <img src="./assets/wecom.jpg" alt="Data+AI Enterprise WeChat group" style="width: 35%; min-width: 300px; display: block; margin: auto;">
  113. </p>
  114. If you like SkillAdam, give it a GitHub Star ⭐
  115. [![Star History Chart](https://api.star-history.com/svg?repos=ruc-datalab/SkillAdam&type=Date&legend=top-left)](https://star-history.com/#ruc-datalab/SkillAdam&type=date&legend=top-left)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.