Skip to main content
Atlan can review a skill’s recent recorded runs and propose changes to its SKILL.md. Editors review the proposed changes and choose which ones to save as a new version.

​
Before you begin

  • Skill improvement must be configured for your account, and you need edit access to the skill.
  • The skill needs enough recent invocations across distinct recorded sessions. The app shows the required counts and the version they apply to.
  • Trace content must be available for the check. Run counts alone do not provide enough evidence to judge instructions.
The suggestions card is visible only to editors. Availability depends on the service’s readiness checks; having a Usage tab does not establish that suggestions are ready.

​
Run the check

  1. Open the skill and select Usage, or find Improve the skill on Overview.
  2. Read the run and session counts. If the card says Suggestions not available yet, collect the missing evidence on the indicated version.
  3. When the card says Ready for suggestions, select Get suggestions.
  4. Follow the progress in Usage while Atlan reads, judges, and reviews the recorded work.
A failed check leaves the skill unchanged. If the runs do not contain enough readable content, the card explains why it could not produce suggestions.

​
Review and apply changes

  1. Expand each suggestion and read its reason and before-and-after diff. A proposal can rewrite the description, replace a section, add a section, or remove one.
  2. Check its supporting evidence. The app links traces you created and counts other supporting runs without exposing their trace content.
  3. Clear the checkboxes for changes you do not want. All suggestions start selected.
  4. Select Apply suggestions. The button names the number selected when applicable; at most six can be accepted in one decision.
  5. Select View changes in the success message, then confirm the new version in Source.
Applying suggestions saves a new version. Its security checks and workspace release policy still determine when people receive it. See Versions and releases. If the skill changed after the check or another editor already decided on the proposal, the service can refuse the apply. Reload the latest state and run another check instead of applying an old diff by hand.

​
Read skill quality

When a judged check is available, Skill quality summarizes the runs it reviewed: The correction rate uses only runs with a later user reply. If none had a reply, there is nothing to count. Select a version to compare the evidence recorded for that version; these judgments describe the reviewed sample, not every execution of the skill.