[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AV0Q87EGSC0EC0W7ST9AAE":3,"skill-same:01M7AV0Q87EGSC0EC0W7ST9AAE":49},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":27,"commitSha":28,"skillDirectory":29,"forksCount":14,"repositoryHtmlUrl":30,"repositoryHomepageUrl":6,"ownerHtmlUrl":31,"ownerBlogUrl":32,"ownerDescription":33,"updatedAt":34,"install":35,"resources":48},"01M7AV0Q87EGSC0EC0W7ST9AAE","reflect",null,"Learning capture system that extracts HIGH\u002FMED\u002FLOW confidence patterns from conversations to prevent repeating mistakes. Use after user corrections (\"no\", \"wrong\"), praise (\"perfect\", \"exactly\"), or when discovering edge cases. Complements .squad\u002Fagents\u002F{agent}\u002Fhistory.md and .squad\u002Fdecisions.md.","alonf\u002FKeyContextAI","alonf","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F554150?v=4","01M7ATEPSCNKG13BVTKA74VG59","Alon Fliess","01M7ATEPSZ4YMBM9W25SKM3GES",0,"MIT","https:\u002F\u002Fgithub.com\u002Falonf\u002FKeyContextAI\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Freflect\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: reflect\ndescription: Learning capture system that extracts HIGH\u002FMED\u002FLOW confidence patterns from conversations to prevent repeating mistakes. Use after user corrections (\"no\", \"wrong\"), praise (\"perfect\", \"exactly\"), or when discovering edge cases. Complements .squad\u002Fagents\u002F{agent}\u002Fhistory.md and .squad\u002Fdecisions.md.\nlicense: MIT\nversion: 1.0.0-squad\ndomain: team-memory, learning\nconfidence: high\n---\n\n# Reflect Skill\n\n**Critical learning capture system** for Squad. Prevents repeating mistakes and preserves successful patterns across sessions.\n\nAnalyze conversations and propose improvements to squad knowledge based on what worked, what didn't, and edge cases discovered. **Every correction is a learning opportunity.**\n\n---\n\n## Integration with Squad Architecture\n\n**Reflect complements existing Squad knowledge systems:**\n\n1. **`.squad\u002Fagents\u002F{agent}\u002Fhistory.md`** — Permanent learnings from completed work (append-only; each agent updates their own file; Scribe propagates cross-agent updates)\n2. **`.squad\u002Fdecisions.md`** — Team-wide decisions that all agents respect\n3. **`reflect` skill** — Captures in-flight learnings from conversations that may graduate to history.md or decisions.md\n\n**Workflow:**\n- Use `reflect` during work to capture learnings\n- At session end, review captured learnings\n- Promote HIGH confidence patterns → lead agent for decision.md review\n- Promote agent-specific patterns → `{agent}\u002Fhistory.md` updates\n\n---\n\n## Triggers\n\n### 🔴 HIGH Priority (Invoke Immediately)\n\n| Trigger | Example | Why Critical |\n|---------|---------|--------------|\n| User correction | \"no\", \"wrong\", \"not like that\", \"never do\" | Captures mistakes to prevent repetition |\n| Architectural insight | \"you removed that without understanding why\" | Documents design decisions (Chesterton's Fence) |\n| Immediate fixes | \"debug\", \"root cause\", \"fix all\" | Learns from errors in real-time |\n\n### 🟡 MEDIUM Priority (Invoke After Multiple)\n\n| Trigger | Example | Why Important |\n|---------|---------|---------------|\n| User praise | \"perfect\", \"exactly\", \"great\" | Reinforces successful patterns |\n| Tool preferences | \"use X instead of Y\", \"prefer\" | Builds workflow preferences |\n| Edge cases | \"what if X happens?\", \"don't forget\", \"ensure\" | Captures scenarios to handle |\n\n### 🟢 LOW Priority (Invoke at Session End)\n\n| Trigger | Example | Why Useful |\n|---------|---------|------------|\n| Repeated patterns | Frequent use of specific commands\u002Ftools | Identifies workflow preferences |\n| Session end | After complex work | Consolidates all session learnings |\n\n---\n\n## Process\n\n### Phase 1: Identify Learning Target\n\nDetermine what knowledge system should be updated:\n\n1. **Agent-specific learning** → `.squad\u002Fagents\u002F{agent}\u002Fhistory.md`\n2. **Team-wide decision** → `.squad\u002Fdecisions\u002Finbox\u002F{agent}-{topic}.md`\n3. **Skill-specific improvement** → Document in session, recommend to skill owner\n\n### Phase 2: Analyze Conversation\n\nScan for learning signals with confidence levels:\n\n#### HIGH Confidence: Corrections\n\nUser actively steered or corrected output.\n\n**Detection patterns:**\n- Explicit rejection: \"no\", \"not like that\", \"that's wrong\"\n- Strong directives: \"never do\", \"always do\", \"don't ever\"\n- User provided alternative implementation\n\n**Example:**\n```text\nUser: \"No, use the azure-devops MCP tool instead of raw API calls\"\n→ [HIGH] + Add constraint: \"Prefer azure-devops MCP tools over REST API\"\n```\n\n#### MEDIUM Confidence: Success Patterns\n\nOutput was accepted or praised.\n\n**Detection patterns:**\n- Explicit praise: \"perfect\", \"great\", \"yes\", \"exactly\"\n- User built on output without modification\n- Output was committed without changes\n\n**Example:**\n```text\nUser: \"Perfect, that's exactly what I needed\"\n→ [MED] + Add preference: \"Include usage examples in documentation\"\n```\n\n#### MEDIUM Confidence: Edge Cases\n\nScenarios not anticipated.\n\n**Detection patterns:**\n- Questions not answered\n- Workarounds user had to apply\n- Error handling gaps discovered\n\n#### LOW Confidence: Preferences\n\nAccumulated patterns over time.\n\n---\n\n### Phase 3: Propose Learnings\n\nPresent findings:\n\n```text\n┌─────────────────────────────────────────────────────────────┐\n│ REFLECTION: {target (agent\u002Fdecision\u002Fskill)}                  │\n├─────────────────────────────────────────────────────────────┤\n│                                                             │\n│ [HIGH] + Add constraint: \"{specific constraint}\"            │\n│   Source: \"{quoted user correction}\"                        │\n│   Target: .squad\u002Fdecisions\u002Finbox\u002F{agent}-{topic}.md         │\n│                                                             │\n│ [MED]  + Add preference: \"{specific preference}\"            │\n│   Source: \"{evidence from conversation}\"                    │\n│   Target: .squad\u002Fagents\u002F{agent}\u002Fhistory.md                  │\n│                                                             │\n│ [LOW]  ~ Note for review: \"{observation}\"                   │\n│   Source: \"{pattern observed}\"                              │\n│   Target: Session notes only                                │\n│                                                             │\n├─────────────────────────────────────────────────────────────┤\n│ Apply changes? [Y\u002Fn\u002Fedit]                                   │\n└─────────────────────────────────────────────────────────────┘\n```\n\n**Confidence Threshold:**\n\n| Threshold | Action |\n|-----------|--------|\n| ≥1 HIGH signal | Always propose (user explicitly corrected) |\n| ≥2 MED signals | Propose (sufficient pattern) |\n| ≥3 LOW signals | Propose (accumulated evidence) |\n| 1-2 LOW only | Skip (insufficient evidence) |\n\n### Phase 4: Persist Learnings\n\n**ALWAYS show changes before applying.**\n\nAfter user approval:\n\n1. **For Agent History:**\n   - Append to `.squad\u002Fagents\u002F{agent}\u002Fhistory.md` under `## Learnings` section\n   - Format: Date, assignment context, key learning\n\n2. **For Team Decisions:**\n   - Create `.squad\u002Fdecisions\u002Finbox\u002F{agent}-{topic}.md`\n   - Lead agent reviews and merges to `decisions.md` if appropriate\n\n3. **For Skills:**\n   - Document recommendation in session notes\n   - Squad lead reviews and routes to skill owner\n\n---\n\n## Usage Examples\n\n### Example 1: User Correction\n\n**Conversation:**\n```\nAgent: \"I'll use grep to search the repository\"\nUser: \"No, use the code search tools first, grep is too slow\"\n```\n\n**Reflection Output:**\n```\n[HIGH] + Add constraint: \"Use code intelligence tools before grep\"\n  Source: \"No, use the code search tools first, grep is too slow\"\n  Target: .squad\u002Fagents\u002F{agent}\u002Fhistory.md\n```\n\n### Example 2: Success Pattern\n\n**Conversation:**\n```\nAgent: [Creates PR with detailed description and test plan]\nUser: \"Perfect! This is exactly the format I want for all PRs\"\n```\n\n**Reflection Output:**\n```\n[MED] + Add preference: \"Include test plan in PR descriptions\"\n  Source: User praised detailed PR format\n  Target: .squad\u002Fdecisions\u002Finbox\u002Fpr-format.md (for team adoption)\n```\n\n---\n\n## When to Use\n\n✅ **Use reflect when:**\n- User says \"no\", \"wrong\", \"not like that\" (HIGH priority)\n- User says \"perfect\", \"exactly\", \"great\" (MED priority)\n- You discover edge cases or gaps\n- Complex work session with multiple learnings\n- At end of sprint\u002Fmilestone to consolidate patterns\n\n❌ **Don't use reflect when:**\n- Simple one-off questions with no pattern\n- User is just exploring ideas (no concrete decisions)\n- Learning is already captured in history.md\u002Fdecisions.md\n\n---\n\n## See Also\n\n- `.squad\u002Fdecisions.md` — Team-wide decisions\n- `.squad\u002Fagents\u002F*\u002Fhistory.md` — Agent-specific learnings\n- `.squad\u002Frouting.md` — Work assignment patterns\n","# Reflect Skill\n\n**Critical learning capture system** for Squad. Prevents repeating mistakes and preserves successful patterns across sessions.\n\nAnalyze conversations and propose improvements to squad knowledge based on what worked, what didn't, and edge cases discovered. **Every correction is a learning opportunity.**\n\n---\n\n## Integration with Squad Architecture\n\n**Reflect complements existing Squad knowledge systems:**\n\n1. **`.squad\u002Fagents\u002F{agent}\u002Fhistory.md`** — Permanent learnings from completed work (append-only; each agent updates their own file; Scribe propagates cross-agent updates)\n2. **`.squad\u002Fdecisions.md`** — Team-wide decisions that all agents respect\n3. **`reflect` skill** — Captures in-flight learnings from conversations that may graduate to history.md or decisions.md\n\n**Workflow:**\n- Use `reflect` during work to capture learnings\n- At session end, review captured learnings\n- Promote HIGH confidence patterns → lead agent for decision.md review\n- Promote agent-specific patterns → `{agent}\u002Fhistory.md` updates\n\n---\n\n## Triggers\n\n### 🔴 HIGH Priority (Invoke Immediately)\n\n| Trigger | Example | Why Critical |\n|---------|---------|--------------|\n| User correction | \"no\", \"wrong\", \"not like that\", \"never do\" | Captures mistakes to prevent repetition |\n| Architectural insight | \"you removed that without understanding why\" | Documents design decisions (Chesterton's Fence) |\n| Immediate fixes | \"debug\", \"root cause\", \"fix all\" | Learns from errors in real-time |\n\n### 🟡 MEDIUM Priority (Invoke After Multiple)\n\n| Trigger | Example | Why Important |\n|---------|---------|---------------|\n| User praise | \"perfect\", \"exactly\", \"great\" | Reinforces successful patterns |\n| Tool preferences | \"use X instead of Y\", \"prefer\" | Builds workflow preferences |\n| Edge cases | \"what if X happens?\", \"don't forget\", \"ensure\" | Captures scenarios to handle |\n\n### 🟢 LOW Priority (Invoke at Session End)\n\n| Trigger | Example | Why Useful |\n|---------|---------|------------|\n| Repeated patterns | Frequent use of specific commands\u002Ftools | Identifies workflow preferences |\n| Session end | After complex work | Consolidates all session learnings |\n\n---\n\n## Process\n\n### Phase 1: Identify Learning Target\n\nDetermine what knowledge system should be updated:\n\n1. **Agent-specific learning** → `.squad\u002Fagents\u002F{agent}\u002Fhistory.md`\n2. **Team-wide decision** → `.squad\u002Fdecisions\u002Finbox\u002F{agent}-{topic}.md`\n3. **Skill-specific improvement** → Document in session, recommend to skill owner\n\n### Phase 2: Analyze Conversation\n\nScan for learning signals with confidence levels:\n\n#### HIGH Confidence: Corrections\n\nUser actively steered or corrected output.\n\n**Detection patterns:**\n- Explicit rejection: \"no\", \"not like that\", \"that's wrong\"\n- Strong directives: \"never do\", \"always do\", \"don't ever\"\n- User provided alternative implementation\n\n**Example:**\n```text\nUser: \"No, use the azure-devops MCP tool instead of raw API calls\"\n→ [HIGH] + Add constraint: \"Prefer azure-devops MCP tools over REST API\"\n```\n\n#### MEDIUM Confidence: Success Patterns\n\nOutput was accepted or praised.\n\n**Detection patterns:**\n- Explicit praise: \"perfect\", \"great\", \"yes\", \"exactly\"\n- User built on output without modification\n- Output was committed without changes\n\n**Example:**\n```text\nUser: \"Perfect, that's exactly what I needed\"\n→ [MED] + Add preference: \"Include usage examples in documentation\"\n```\n\n#### MEDIUM Confidence: Edge Cases\n\nScenarios not anticipated.\n\n**Detection patterns:**\n- Questions not answered\n- Workarounds user had to apply\n- Error handling gaps discovered\n\n#### LOW Confidence: Preferences\n\nAccumulated patterns over time.\n\n---\n\n### Phase 3: Propose Learnings\n\nPresent findings:\n\n```text\n┌─────────────────────────────────────────────────────────────┐\n│ REFLECTION: {target (agent\u002Fdecision\u002Fskill)}                  │\n├─────────────────────────────────────────────────────────────┤\n│                                                             │\n│ [HIGH] + Add constraint: \"{specific constraint}\"            │\n│   Source: \"{quoted user correction}\"                        │\n│   Target: .squad\u002Fdecisions\u002Finbox\u002F{agent}-{topic}.md         │\n│                                                             │\n│ [MED]  + Add preference: \"{specific preference}\"            │\n│   Source: \"{evidence from conversation}\"                    │\n│   Target: .squad\u002Fagents\u002F{agent}\u002Fhistory.md                  │\n│                                                             │\n│ [LOW]  ~ Note for review: \"{observation}\"                   │\n│   Source: \"{pattern observed}\"                              │\n│   Target: Session notes only                                │\n│                                                             │\n├─────────────────────────────────────────────────────────────┤\n│ Apply changes? [Y\u002Fn\u002Fedit]                                   │\n└─────────────────────────────────────────────────────────────┘\n```\n\n**Confidence Threshold:**\n\n| Threshold | Action |\n|-----------|--------|\n| ≥1 HIGH signal | Always propose (user explicitly corrected) |\n| ≥2 MED signals | Propose (sufficient pattern) |\n| ≥3 LOW signals | Propose (accumulated evidence) |\n| 1-2 LOW only | Skip (insufficient evidence) |\n\n### Phase 4: Persist Learnings\n\n**ALWAYS show changes before applying.**\n\nAfter user approval:\n\n1. **For Agent History:**\n   - Append to `.squad\u002Fagents\u002F{agent}\u002Fhistory.md` under `## Learnings` section\n   - Format: Date, assignment context, key learning\n\n2. **For Team Decisions:**\n   - Create `.squad\u002Fdecisions\u002Finbox\u002F{agent}-{topic}.md`\n   - Lead agent reviews and merges to `decisions.md` if appropriate\n\n3. **For Skills:**\n   - Document recommendation in session notes\n   - Squad lead reviews and routes to skill owner\n\n---\n\n## Usage Examples\n\n### Example 1: User Correction\n\n**Conversation:**\n```\nAgent: \"I'll use grep to search the repository\"\nUser: \"No, use the code search tools first, grep is too slow\"\n```\n\n**Reflection Output:**\n```\n[HIGH] + Add constraint: \"Use code intelligence tools before grep\"\n  Source: \"No, use the code search tools first, grep is too slow\"\n  Target: .squad\u002Fagents\u002F{agent}\u002Fhistory.md\n```\n\n### Example 2: Success Pattern\n\n**Conversation:**\n```\nAgent: [Creates PR with detailed description and test plan]\nUser: \"Perfect! This is exactly the format I want for all PRs\"\n```\n\n**Reflection Output:**\n```\n[MED] + Add preference: \"Include test plan in PR descriptions\"\n  Source: User praised detailed PR format\n  Target: .squad\u002Fdecisions\u002Finbox\u002Fpr-format.md (for team adoption)\n```\n\n---\n\n## When to Use\n\n✅ **Use reflect when:**\n- User says \"no\", \"wrong\", \"not like that\" (HIGH priority)\n- User says \"perfect\", \"exactly\", \"great\" (MED priority)\n- You discover edge cases or gaps\n- Complex work session with multiple learnings\n- At end of sprint\u002Fmilestone to consolidate patterns\n\n❌ **Don't use reflect when:**\n- Simple one-off questions with no pattern\n- User is just exploring ideas (no concrete decisions)\n- Learning is already captured in history.md\u002Fdecisions.md\n\n---\n\n## See Also\n\n- `.squad\u002Fdecisions.md` — Team-wide decisions\n- `.squad\u002Fagents\u002F*\u002Fhistory.md` — Agent-specific learnings\n- `.squad\u002Frouting.md` — Work assignment patterns\n",{"name":5,"domain":24,"license":15,"version":25,"confidence":26,"description":7},"team-memory, learning","1.0.0-squad","high","main","176da577bfd98859f793bdd1312690c6c3940c67",".github\u002Fskills\u002Freflect","https:\u002F\u002Fgithub.com\u002Falonf\u002FKeyContextAI","https:\u002F\u002Fgithub.com\u002Falonf","http:\u002F\u002Falonfliess.me","CTO & Founder of Zionet.\r\nMicrosoft Regional Director and Foundry MVP.\r\n","2026-08-28 05:21:35",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add alonf\u002FKeyContextAI --skill reflect",{"tool":41,"command":42},"bunx","bunx skills add alonf\u002FKeyContextAI --skill reflect",{"tool":44,"command":45},"pnpm","pnpm dlx skills add alonf\u002FKeyContextAI --skill reflect","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Falonf\u002FKeyContextAI\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Freflect\u002FSKILL.md",true,[],[50,57,64,71,78,85],{"skillNo":51,"name":52,"nameZh":6,"description":53,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":54,"categories":55,"keywords":56,"publishedAt":19},"01M7AVHRWWXA0BQ5PXNA8FG30W","windows-compatibility","Cross-platform path handling and command patterns","https:\u002F\u002Fgithub.com\u002Falonf\u002FKeyContextAI\u002Fblob\u002Fmain\u002F.squad\u002Ftemplates\u002Fskills\u002Fwindows-compatibility\u002FSKILL.md",[],[],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":19},"01M7AVHABPRYXYM3GWJY1RW92A","versioning-policy","Semver versioning rules for Squad SDK and CLI — prevents prerelease version incidents","https:\u002F\u002Fgithub.com\u002Falonf\u002FKeyContextAI\u002Fblob\u002Fmain\u002F.squad\u002Ftemplates\u002Fskills\u002Fversioning-policy\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M7AVH4KNP3TCVQDRVS70VP19","tiered-memory","Three-tier agent memory model (hot\u002Fcold\u002Fwiki) for context reduction per spawn","https:\u002F\u002Fgithub.com\u002Falonf\u002FKeyContextAI\u002Fblob\u002Fmain\u002F.squad\u002Ftemplates\u002Fskills\u002Ftiered-memory\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M7AVH18JDSA55Z7KK2GH6X49","test-discipline","Update tests when changing APIs — no exceptions","https:\u002F\u002Fgithub.com\u002Falonf\u002FKeyContextAI\u002Fblob\u002Fmain\u002F.squad\u002Ftemplates\u002Fskills\u002Ftest-discipline\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M7AVGVGWYD7NBNXAV4PAZJ92","squad","Squad's command catalog and interactive menu. Invoke via \u002Fsquad (slash command) or natural language (\"squad commands\", \"what can squad do\", \"show me squad options\"). Presents categorized operations (Install & Upgrade, Team Management, Issues & PRs, Plugins & Skills, Model & Cost, Sessions & State) as an interactive picker. Routes to the right squad CLI command or the Squad coordinator agent.","https:\u002F\u002Fgithub.com\u002Falonf\u002FKeyContextAI\u002Fblob\u002Fmain\u002F.squad\u002Ftemplates\u002Fskills\u002Fsquad\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M7AVGPSFT1WHW3PK35DHS5XK","squad-version-check","Internals of how @bradygaster\u002Fsquad-cli stamps its version, how `squad upgrade` works (what it preserves vs overwrites), and how to probe the npm registry for the latest version from a coordinator prompt.","https:\u002F\u002Fgithub.com\u002Falonf\u002FKeyContextAI\u002Fblob\u002Fmain\u002F.squad\u002Ftemplates\u002Fskills\u002Fsquad-version-check\u002FSKILL.md",[],[]]