From c97da7e1ee5ba9e5bb010a309b14dad52e8e851a Mon Sep 17 00:00:00 2001
From: Pallav46 <pallavkumar6200@gmail.com>
Date: Sat, 25 Apr 2026 04:48:41 +0530
Subject: [PATCH] feat(integrations): change Augment from flat rules to skill
 bundles

- Convert Augment integration from flat .augment/rules/*.md to directory-based .augment/skills/<name>/SKILL.md structure
- Align Augment format with Windsurf and OpenCode skill bundle pattern
- Copy supporting folders (scripts/, references/, templates/) to each Augment skill directory
- Update frontmatter from 'type: auto' to standard 'name' + 'description' fields
- Update README documentation for new directory-based installation path

This change is possible because Augment Code now supports skills in beta, allowing us to move from the flat rules format to full skill bundles. This gives Augment users access to the complete skill ecosystem including Python automation tools and reference documentation, not just the markdown content.
---
 scripts/convert.sh | 18 ++++++++++--------
 scripts/install.sh |  2 +-
 2 files changed, 11 insertions(+), 9 deletions(-)

diff --git a/scripts/convert.sh b/scripts/convert.sh
index eff95eae..1034d987 100755
--- a/scripts/convert.sh
+++ b/scripts/convert.sh
@@ -362,9 +362,9 @@ write_tool_readme() {
       update_step='Re-run `./scripts/convert.sh --tool opencode` and reinstall with `./scripts/install.sh --tool opencode --target <project-dir>`.'
       ;;
     augment)
-      format_line='Flat Augment rules: `rules/<skill-name>.md` with Augment frontmatter (`type: auto`, `description`).'
-      manual_install='Copy `integrations/augment/rules/*.md` into your project `.augment/rules/` directory.'
-      verify_step='Run `find .augment/rules -name "*.md" | wc -l` and check rules appear in Augment.'
+      format_line='Directory skill bundles: `skills/<skill-name>/SKILL.md` with Augment-compatible SKILL frontmatter (`name`, `description`) plus copied support folders.'
+      manual_install='Copy each folder from `integrations/augment/skills/<skill-name>/` to `.augment/skills/<skill-name>/` in your project.'
+      verify_step='Run `find .augment/skills -name "SKILL.md" | wc -l` and verify skills are listed in Augment.'
       update_step='Re-run `./scripts/convert.sh --tool augment` and reinstall with `./scripts/install.sh --tool augment --target <project-dir>`.'
       ;;
   esac
@@ -446,10 +446,10 @@ info "Found ${TOTAL_CANDIDATES} candidate skills"
 for t in $TOOLS; do
   rm -rf "${OUT_BASE}/${t}"
   mkdir -p "${OUT_BASE}/${t}"
-  if [[ "$t" == "cursor" || "$t" == "kilocode" || "$t" == "augment" ]]; then
+  if [[ "$t" == "cursor" || "$t" == "kilocode" ]]; then
     mkdir -p "${OUT_BASE}/${t}/rules"
   fi
-  if [[ "$t" == "windsurf" || "$t" == "opencode" ]]; then
+  if [[ "$t" == "windsurf" || "$t" == "opencode" || "$t" == "augment" ]]; then
     mkdir -p "${OUT_BASE}/${t}/skills"
   fi
   if [[ "$t" == "aider" ]]; then
@@ -554,14 +554,16 @@ while IFS= read -r rel_path; do
         copy_supporting_dirs "$src_dir" "$out_dir"
         ;;
       augment)
-        out_file="${OUT_BASE}/augment/rules/${name}.md"
+        out_dir="${OUT_BASE}/augment/skills/${name}"
+        mkdir -p "$out_dir"
         {
           echo "---"
-          echo "type: auto"
+          echo "name: $(yaml_quote "$name")"
           echo "description: $(yaml_quote "$description")"
           echo "---"
           cat "$body_tmp"
-        } > "$out_file"
+        } > "${out_dir}/SKILL.md"
+        copy_supporting_dirs "$src_dir" "$out_dir"
         ;;
       *)
         err "Unhandled tool: ${t}"
diff --git a/scripts/install.sh b/scripts/install.sh
index f15bcf91..bdfed458 100755
--- a/scripts/install.sh
+++ b/scripts/install.sh
@@ -264,7 +264,7 @@ case "$TOOL" in
     install_skill_bundle_tool "opencode"
     ;;
   augment)
-    install_flat_rules_tool "augment" ".augment/rules" ".md"
+    install_skill_bundle_tool "augment"
     ;;
   *)
     err "Unhandled tool: ${TOOL}"