feat: Auto-enhance SKILL.md when --enhance or --comprehensive flag is used

UX improvement: When running `skill-seekers analyze --enhance` or
`skill-seekers analyze --comprehensive`, the SKILL.md is now automatically
enhanced as the final step. No need for a separate `skill-seekers enhance`
command.

Changes:
- After analyze_main() completes successfully, check if --enhance or
  --comprehensive was used
- If SKILL.md exists, automatically run SkillEnhancer in headless mode
- Use force=True to skip all prompts (consistent with --comprehensive UX)
- 10 minute timeout for large codebases
- Graceful fallback with retry instructions if enhancement fails

Before (bad UX):
  skill-seekers analyze --directory /path --enhance
  # Then separately:
  skill-seekers enhance output/codebase/

After (good UX):
  skill-seekers analyze --directory /path --enhance
  # Everything done in one command!

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

src/skill_seekers/cli/main.py

@@ -34,6 +34,7 @@ Examples:
 
 import argparse
 import sys
+from pathlib import Path
 
 from skill_seekers.cli import __version__
 
@@ -588,7 +589,45 @@ def main(argv: list[str] | None = None) -> int:
             if args.verbose:
                 sys.argv.append("--verbose")
 
-            return analyze_main() or 0
+            result = analyze_main() or 0
+
+            # If --enhance or --comprehensive was used, also enhance the SKILL.md
+            if result == 0 and (args.enhance or args.comprehensive):
+                skill_dir = Path(args.output)
+                skill_md = skill_dir / "SKILL.md"
+
+                if skill_md.exists():
+                    print("\n" + "=" * 60)
+                    print("ENHANCING SKILL.MD WITH AI")
+                    print("=" * 60 + "\n")
+
+                    try:
+                        from skill_seekers.cli.enhance_skill_local import SkillEnhancer
+
+                        enhancer = SkillEnhancer(str(skill_dir))
+                        # Use headless mode with force (no prompts)
+                        success = enhancer.enhance(
+                            mode="headless",
+                            force=True,
+                            timeout=600,  # 10 minute timeout
+                        )
+
+                        if success:
+                            print("\n✅ SKILL.md enhancement complete!")
+                            # Re-read line count
+                            with open(skill_md) as f:
+                                lines = len(f.readlines())
+                            print(f"   Enhanced SKILL.md: {lines} lines")
+                        else:
+                            print("\n⚠️  SKILL.md enhancement did not complete")
+                            print("   You can retry with: skill-seekers enhance " + str(skill_dir))
+                    except Exception as e:
+                        print(f"\n⚠️  SKILL.md enhancement failed: {e}")
+                        print("   You can retry with: skill-seekers enhance " + str(skill_dir))
+                else:
+                    print(f"\n⚠️  SKILL.md not found at {skill_md}, skipping enhancement")
+
+            return result
 
         elif args.command == "install-agent":
             from skill_seekers.cli.install_agent import main as install_agent_main