agentsys 5.0.3 → 5.2.0

package/adapters/codex/skills/learn/SKILL.md

@@ -1,188 +0,0 @@
-<!-- AUTO-GENERATED by scripts/gen-adapters.js - DO NOT EDIT -->
----
-name: learn
-description: "Use when user asks to \"learn about topic\", \"research subject\", \"create learning guide\", \"build knowledge base\", \"study topic\". Gathers online sources and synthesizes comprehensive guide with RAG index."
----
-
-# /learn - Learning Guide Generator
-
-Research any topic by gathering online resources and synthesize into a comprehensive learning guide with RAG-optimized indexes.
-
-## Depth Levels
-
-| Level | Sources | Use Case |
-|-------|---------|----------|
-| `brief` | 10 | Quick overview, time-sensitive |
-| `medium` | 20 | **Default** - balanced coverage |
-| `deep` | 40 | Comprehensive, academic depth |
-
-## Arguments
-
-Parse from $ARGUMENTS:
-
-- **topic**: The subject to learn about (required)
-- **--depth**: `brief` (10 sources), `medium` (20, default), or `deep` (40)
-- **--no-enhance**: Skip enhancement pass (default: enhance enabled)
-
-## Execution
-
-### Phase 1: Parse Arguments
-
-```javascript
-const args = '$ARGUMENTS';
-
-// Extract depth flag
-const depthMatch = args.match(/--depth=(brief|medium|deep)/);
-const depth = depthMatch ? depthMatch[1] : 'medium';
-const noEnhance = args.includes('--no-enhance');
-
-// Extract topic (everything except flags)
-const topic = args
-  .replace(/--depth=(brief|medium|deep)/g, '')
-  .replace(/--no-enhance/g, '')
-  .trim();
-
-if (!topic) {
-  return 'Usage: /learn <topic> [--depth=brief|medium|deep]';
-}
-
-// Generate slug for filenames
-const slug = topic
-  .toLowerCase()
-  .replace(/[^a-z0-9\s-]/g, '')
-  .replace(/\s+/g, '-')
-  .replace(/-+/g, '-')
-  .replace(/^-|-$/g, '')
-  .substring(0, 64);
-
-// Source counts by depth
-const sourceCounts = { brief: 10, medium: 20, deep: 40 };
-const minSources = sourceCounts[depth];
-```
-
-### Phase 2: Check Existing Guide
-
-```javascript
-// Check if guide already exists
-const existingGuide = await Glob({ pattern: `agent-knowledge/${slug}.md` });
-
-if (existingGuide.length > 0) {
-  // Ask user: update existing or create fresh?
-  const choice = await request_user_input({
-    questions: [{
-      question: `A guide for "${topic}" already exists. What would you like to do?`,
-      header: 'Existing guide',
-      options: [
-        { label: 'Update existing', description: 'Add new sources and refresh content' },
-        { label: 'Create fresh', description: 'Start over with new research' }
-      ],
-    }]
-  });
-
-  if (choice === 'Create fresh') {
-    // Will overwrite
-  }
-}
-```
-
-### Phase 3: Spawn Learn Agent
-
-```javascript
-const taskOutput = await Task({
-  subagent_type: "learn:learn-agent",
-  model: "opus",
-  prompt: `Research and create a learning guide.
-
-Topic: ${topic}
-Slug: ${slug}
-Depth: ${depth}
-Min Sources: ${minSources}
-Enhance: ${!noEnhance}
-
-Output directory: agent-knowledge/
-
-Create:
-1. ${slug}.md - Comprehensive learning guide
-2. resources/${slug}-sources.json - Source metadata with confidence ratings
-3. Update CLAUDE.md and AGENTS.md master indexes
-
-Return structured results between === LEARN_RESULT === markers.`
-});
-```
-
-### Phase 4: Parse Results
-
-```javascript
-function parseLearnResult(output) {
-  const match = output.match(/=== LEARN_RESULT ===[\s\S]*?({[\s\S]*?})[\s\S]*?=== END_RESULT ===/);
-  return match ? JSON.parse(match[1]) : null;
-}
-
-const result = parseLearnResult(taskOutput);
-```
-
-### Phase 5: Present Results
-
-```markdown
-## Learning Guide Created
-
-**Topic**: {topic}
-**File**: agent-knowledge/{slug}.md
-**Sources**: {sourceCount} resources analyzed
-
-### Quality Assessment
-
-| Metric | Rating |
-|--------|--------|
-| Coverage | {coverage}/10 |
-| Source Diversity | {diversity}/10 |
-| Example Quality | {examples}/10 |
-| Confidence | {confidence}/10 |
-
-### Source Breakdown
-
-| Type | Count |
-|------|-------|
-| Official Docs | {n} |
-| Tutorials | {n} |
-| Q&A/Stack Overflow | {n} |
-| Blog Posts | {n} |
-| GitHub Examples | {n} |
-
-### Next Steps
-
-- [ ] Review the guide at `agent-knowledge/{slug}.md`
-- [ ] Check source quality in `agent-knowledge/resources/{slug}-sources.json`
-- [ ] Run `/learn {related-topic}` to expand your knowledge base
-```
-
-## Output Structure
-
-Each `/learn` run creates/updates:
-
-```
-agent-knowledge/
-  CLAUDE.md           # Master index (updated)
-  AGENTS.md           # Master index for OpenCode/Codex (updated)
-  {slug}.md           # Topic-specific guide (created)
-  resources/
-    {slug}-sources.json  # Source metadata (created)
-```
-
-## Error Handling
-
-| Error | Action |
-|-------|--------|
-| No topic provided | Show usage help |
-| WebSearch fails | Retry with alternative queries |
-| Insufficient sources | Warn user, proceed with available |
-| Enhancement fails | Skip enhancement, note in output |
-
-## Example Usage
-
-```bash
-/learn recursion
-/learn react hooks --depth=deep
-/learn "kubernetes networking" --depth=brief
-/learn python async --no-enhance
-```