claude-skills-cli 0.0.5 → 0.0.7

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/skills/skill-creator/SKILL.md

@@ -8,136 +8,54 @@ description:
 
 # Skill Creator
 
-Principles and patterns for designing effective Claude Skills.
-
-## Quick Start
-
-Creating a minimal skill:
-
-1. Create directory: `.claude/skills/my-skill/`
-2. Create `SKILL.md` with frontmatter (name, description) and body
-3. Test in conversation
-4. Add references/ as content grows
+Create effective Claude Skills using progressive disclosure.
 
 ## When to Create a Skill
 
 Create a skill when you notice:
 
-- **Repeating context** across conversations (same schema, patterns,
+- **Repeating context** across conversations (schemas, patterns,
   rules)
 - **Domain expertise** needed repeatedly (API integration, framework
   conventions)
-- **Project-specific knowledge** that Claude should know automatically
-
-Example: "I keep explaining this database schema" → Create a
-database-schema skill.
-
-## Skill Architecture
+- **Project-specific knowledge** Claude should know automatically
 
-Skills are directories with this structure:
+## Skill Structure
 
 ```
 my-skill/
-├── SKILL.md          # Required: Instructions + metadata
-├── references/       # Optional: Detailed documentation
-├── scripts/          # Optional: Executable operations
-└── assets/           # Optional: Templates, images, files
+├── SKILL.md          # Core instructions + metadata
+├── references/       # Detailed docs (loaded as needed)
+├── scripts/          # Executable operations
+└── assets/           # Templates, images, files
 ```
 
-**SKILL.md** - Core instructions with YAML frontmatter (name,
-description) + markdown body
-
-**references/** - Detailed docs loaded only when Claude needs them
-(schemas, API docs, guides)
-
-**scripts/** - Deterministic operations Claude can execute without
-generating code (validation, generation)
-
-**assets/** - Files used directly in output without loading into
-context (templates, images)
-
 ## Progressive Disclosure
 
 Skills load in 3 levels:
 
-**Level 1: Metadata** (~100 tokens, always loaded) - YAML frontmatter
-determines skill triggering
-
-**Level 2: Instructions** (<5k tokens, when triggered) - SKILL.md body
-with core patterns and links
-
-**Level 3: Resources** (unlimited, as needed) - references/ scripts/
-assets/ loaded only when used
-
-**Key principle**: Keep Levels 1 & 2 lean. Move details to Level 3.
-
-## Development Process
+1. **Metadata** (~27 tokens) - YAML frontmatter for triggering
+2. **Instructions** (<680 tokens) - SKILL.md body with core patterns
+3. **Resources** (unlimited) - references/ scripts/ assets/ loaded on
+   demand
 
-1. **Recognize** - Notice repeated context or domain needs
-2. **Gather** - Collect 3-5 concrete examples of skill usage
-3. **Plan** - Decide what goes in SKILL.md vs references/ vs scripts/
-4. **Structure** - Create directory with SKILL.md and needed
-   subdirectories
-5. **Write** - Craft description, then SKILL.md body following
-   patterns
-6. **Enhance** - Add references, scripts, assets as needed
-7. **Iterate** - Test in conversations, refine based on actual usage
+**Key**: Keep Levels 1 & 2 lean. Move details to Level 3.
 
-## Writing Effective Content
-
-**Descriptions**: Include "Use when..." triggers, <200 chars optimal.
-Format: [Domain] + [Operations] + [Trigger keywords]
-
-**SKILL.md Body**: Target ~50 lines, max ~150. Structure: Quick
-Start + Core Patterns (3-5) + Links. Use imperative voice, concrete
-examples.
-
-**References**: Detailed docs with no size limit. Use descriptive
-filenames.
-
-## Common Patterns
-
-**Succeeds**: Domain expertise, concrete examples, keyword-rich
-descriptions, clear triggers, scripts for deterministic tasks
-
-**Fails**: Generic descriptions, bloated SKILL.md, second person
-voice, missing triggers, vague content
-
-See [skill-examples.md](references/skill-examples.md) for detailed
-patterns.
-
-## Implementation
-
-Skills can be created manually (mkdir, touch SKILL.md) or using tools
-like `claude-skills-cli`.
+## Quick Start
 
-For tool usage, see [cli-reference.md](references/cli-reference.md).
+1. Create directory: `.claude/skills/my-skill/`
+2. Create `SKILL.md` with frontmatter and body
+3. Test in conversation
+4. Add references/ as content grows
 
 ## Reference Documentation
 
-For detailed guidance:
-
+- [writing-guide.md](references/writing-guide.md) - Writing effective
+  skills
+- [development-process.md](references/development-process.md) -
+  Step-by-step workflow
+- [skill-examples.md](references/skill-examples.md) - Patterns and
+  examples
+- [cli-reference.md](references/cli-reference.md) - CLI tool usage
 - [anthropic-resources.md](references/anthropic-resources.md) -
-  Official Anthropic best practices
-- [writing-guide.md](references/writing-guide.md) - Voice, structure,
-  and code examples
-- [skill-examples.md](references/skill-examples.md) - Real-world
-  patterns and anti-patterns
-- [cli-reference.md](references/cli-reference.md) - Tool commands
-  (claude-skills-cli)
-- [cli-feedback.md](references/cli-feedback.md) - Real-world CLI usage
-  patterns
-
-## Notes
-
-- Skills are iterative - start minimal, refine through real usage
-- Description drives discovery - invest time in crafting it
-- Test in actual conversations to validate effectiveness
-- Progressive disclosure is key - resist urge to front-load everything
-
-<!--
-PROGRESSIVE DISCLOSURE:
-- This is Level 2 - principles and architecture only
-- Tool-specific details are in references/
-- Target: ~75 lines for optimal scannability
--->
+  Official best practices

package/dist/skills/skill-creator/references/cli-reference.md

@@ -9,13 +9,13 @@ Complete command-line reference for the `claude-skills-cli` tool
 
 ```bash
 npm install -g claude-skills-cli
-claude-skills --version
+claude-skills-cli --version
 ```
 
 ### Using npx (No Installation)
 
 ```bash
-npx claude-skills <command>
+npx claude-skills-cli <command>
 ```
 
 ### Using pnpm
@@ -32,9 +32,9 @@ npm install --save-dev claude-skills-cli
 # Use via package.json scripts
 {
   "scripts": {
-    "skill:init": "claude-skills init",
-    "skill:validate": "claude-skills validate",
-    "skill:package": "claude-skills package"
+    "skill:init": "claude-skills-cli init",
+    "skill:validate": "claude-skills-cli validate",
+    "skill:package": "claude-skills-cli package"
   }
 }
 ```
@@ -50,7 +50,7 @@ Create a new skill directory with standard structure.
 #### Syntax
 
 ```bash
-claude-skills init [options]
+claude-skills-cli init [options]
 ```
 
 #### Options
@@ -67,17 +67,17 @@ claude-skills init [options]
 
 ```bash
 # Create skill with default location (.claude/skills/)
-npx claude-skills init --name my-skill
+npx claude-skills-cli init --name my-skill
 
 # With description
-npx claude-skills init --name my-skill \
+npx claude-skills-cli init --name my-skill \
   --description "SQLite queries. Use when writing database operations"
 
 # Custom path
-npx claude-skills init --path /custom/path/my-skill
+npx claude-skills-cli init --path /custom/path/my-skill
 
 # Custom path with description
-npx claude-skills init --path /custom/path/my-skill \
+npx claude-skills-cli init --path /custom/path/my-skill \
   --description "Brief description"
 ```
 
@@ -109,7 +109,7 @@ Next steps:
 3. Add executable scripts to scripts/
 4. Remove example files you don't need
 
-Validate with: claude-skills validate .claude/skills/my-skill
+Validate with: claude-skills-cli validate .claude/skills/my-skill
 ```
 
 ---
@@ -121,7 +121,7 @@ Validate skill structure and progressive disclosure compliance.
 #### Syntax
 
 ```bash
-claude-skills validate <skill_path> [options]
+claude-skills-cli validate <skill_path> [options]
 ```
 
 #### Arguments
@@ -140,14 +140,14 @@ claude-skills validate <skill_path> [options]
 
 ```bash
 # Validate skill
-npx claude-skills validate .claude/skills/my-skill
+npx claude-skills-cli validate .claude/skills/my-skill
 
 # Strict mode (warnings = errors)
-npx claude-skills validate .claude/skills/my-skill --strict
+npx claude-skills-cli validate .claude/skills/my-skill --strict
 
 # Validate multiple skills
-npx claude-skills validate .claude/skills/skill-1
-npx claude-skills validate .claude/skills/skill-2
+npx claude-skills-cli validate .claude/skills/skill-1
+npx claude-skills-cli validate .claude/skills/skill-2
 ```
 
 #### Validation Checks
@@ -255,7 +255,7 @@ Package skill into a zip file for distribution.
 #### Syntax
 
 ```bash
-claude-skills package <skill_path> [options]
+claude-skills-cli package <skill_path> [options]
 ```
 
 #### Arguments
@@ -275,13 +275,13 @@ claude-skills package <skill_path> [options]
 
 ```bash
 # Package skill (validates first)
-npx claude-skills package .claude/skills/my-skill
+npx claude-skills-cli package .claude/skills/my-skill
 
 # Custom output directory
-npx claude-skills package .claude/skills/my-skill --output builds/
+npx claude-skills-cli package .claude/skills/my-skill --output builds/
 
 # Skip validation (not recommended)
-npx claude-skills package .claude/skills/my-skill --skip-validation
+npx claude-skills-cli package .claude/skills/my-skill --skip-validation
 ```
 
 #### Excluded Files
@@ -325,7 +325,7 @@ The created zip can be:
 
 ```bash
 # 1. Create skill
-npx claude-skills init --name database-queries \
+npx claude-skills-cli init --name database-queries \
   --description "SQLite queries. Use when writing SELECT, INSERT, UPDATE"
 
 # 2. Edit SKILL.md
@@ -335,13 +335,13 @@ vim .claude/skills/database-queries/SKILL.md
 vim .claude/skills/database-queries/references/schema.md
 
 # 4. Validate
-npx claude-skills validate .claude/skills/database-queries
+npx claude-skills-cli validate .claude/skills/database-queries
 
 # 5. Fix any issues, re-validate
-npx claude-skills validate .claude/skills/database-queries
+npx claude-skills-cli validate .claude/skills/database-queries
 
 # 6. Package
-npx claude-skills package .claude/skills/database-queries
+npx claude-skills-cli package .claude/skills/database-queries
 ```
 
 ### Strict Validation in CI
@@ -350,7 +350,7 @@ npx claude-skills package .claude/skills/database-queries
 # package.json
 {
   "scripts": {
-    "test:skills": "claude-skills validate .claude/skills/* --strict"
+    "test:skills": "claude-skills-cli validate .claude/skills/* --strict"
   }
 }
 
@@ -364,7 +364,7 @@ npm run test:skills
 # Bash script to validate all skills
 for skill in .claude/skills/*/; do
   echo "Validating $skill"
-  npx claude-skills validate "$skill" || exit 1
+  npx claude-skills-cli validate "$skill" || exit 1
 done
 ```
 
@@ -372,8 +372,8 @@ done
 
 ```bash
 # One-liner with validation
-npx claude-skills init --name my-skill --description "Brief desc" && \
-  npx claude-skills validate .claude/skills/my-skill
+npx claude-skills-cli init --name my-skill --description "Brief desc" && \
+  npx claude-skills-cli validate .claude/skills/my-skill
 ```
 
 ---
@@ -473,10 +473,10 @@ description: Database helper
 ```json
 {
 	"scripts": {
-		"skill:new": "claude-skills init",
-		"skill:validate": "claude-skills validate .claude/skills/*",
-		"skill:validate:strict": "claude-skills validate .claude/skills/* --strict",
-		"skill:package": "claude-skills package",
+		"skill:new": "claude-skills-cli init",
+		"skill:validate": "claude-skills-cli validate .claude/skills/*",
+		"skill:validate:strict": "claude-skills-cli validate .claude/skills/* --strict",
+		"skill:package": "claude-skills-cli package",
 		"skill:check": "npm run skill:validate:strict"
 	},
 	"devDependencies": {
@@ -491,11 +491,11 @@ description: Database helper
 
 ```bash
 # Check CLI version
-npx claude-skills --version
+npx claude-skills-cli --version
 
 # Show help
-npx claude-skills --help
-npx claude-skills init --help
+npx claude-skills-cli --help
+npx claude-skills-cli init --help
 ```
 
 ---

package/dist/skills/skill-creator/references/development-process.md

@@ -0,0 +1,208 @@
+# Development Process
+
+Step-by-step workflow for creating effective Claude Skills.
+
+## The Seven Steps
+
+### 1. Recognize
+
+Notice when you're repeatedly providing the same context or domain
+knowledge:
+
+- Explaining the same database schema multiple times
+- Providing API integration details in every conversation
+- Sharing framework-specific conventions repeatedly
+- Teaching the same domain concepts
+
+**Signal**: "I've explained this 3+ times in different conversations"
+
+### 2. Gather
+
+Collect 3-5 concrete examples of how you've used this knowledge:
+
+- Save conversation snippets showing the repeated context
+- Document the specific questions or tasks that triggered the need
+- Note the exact information you provided each time
+- Identify common patterns across usage
+
+**Output**: A collection of real usage examples
+
+### 3. Plan
+
+Decide information hierarchy:
+
+**SKILL.md (Level 2)** - Core patterns only:
+
+- What the skill does
+- When to use it
+- Essential structure/commands
+- Links to references
+
+**references/ (Level 3)** - Detailed docs:
+
+- Complete API documentation
+- Detailed examples and tutorials
+- Background and theory
+- Edge cases and troubleshooting
+
+**scripts/ (Level 3)** - Deterministic operations:
+
+- Validation logic
+- Code generation
+- File transformations
+- Data processing
+
+**assets/ (Level 3)** - Static resources:
+
+- Templates
+- Configuration files
+- Images and diagrams
+
+### 4. Structure
+
+Create the directory structure:
+
+```bash
+mkdir -p .claude/skills/my-skill/{references,scripts,assets}
+touch .claude/skills/my-skill/SKILL.md
+```
+
+### 5. Write
+
+#### Write Description First
+
+The description is critical for skill discovery. Format:
+
+```
+[Domain/Context] [operations/capabilities]. Use when [trigger scenarios].
+```
+
+Examples:
+
+- ✅ "PostgreSQL schema and query patterns. Use when designing
+  databases, writing queries, or optimizing performance."
+- ✅ "Next.js 14 App Router conventions. Use when building Next.js
+  apps, configuring routes, or implementing server components."
+- ❌ "A skill for databases" (too vague)
+- ❌ "This skill helps you work with PostgreSQL databases" (second
+  person)
+
+Target: <200 chars for optimal Level 1 efficiency
+
+#### Write SKILL.md Body
+
+Structure:
+
+1. **Brief intro** (1-2 lines) - What this skill provides
+2. **When to use** (3-5 bullets) - Triggering scenarios
+3. **Core patterns** (3-5 sections) - Essential knowledge
+4. **Links to references** - Point to detailed docs
+
+Guidelines:
+
+- Use imperative voice ("Use X for Y", not "You should use X")
+- Provide concrete examples, not abstract concepts
+- Keep it scannable with clear headings
+- Target ~50 lines, max ~150 lines
+- Link liberally to references/
+
+#### Write References
+
+No size limits - be as detailed as needed:
+
+- Use descriptive filenames (api-endpoints.md, not reference.md)
+- Structure with clear headings
+- Include code examples
+- Cover edge cases
+- Provide context and rationale
+
+### 6. Enhance
+
+Add progressive enhancements:
+
+**Scripts** - When operations are:
+
+- Deterministic (same input = same output)
+- Complex (would require Claude to generate code)
+- Reusable (used frequently)
+
+Examples: validators, code generators, formatters
+
+**Assets** - When you need:
+
+- Templates (boilerplate code, config files)
+- Static files (images, data files)
+- Resources that shouldn't be loaded into context
+
+### 7. Iterate
+
+Test and refine:
+
+**Testing**:
+
+- Start a new conversation
+- Trigger the skill naturally (don't force it)
+- Observe if Claude loads it appropriately
+- Check if the content is helpful and sufficient
+
+**Refining**:
+
+- If skill loads too often → Make description more specific
+- If skill never loads → Add trigger keywords to description
+- If Claude asks for info that's in references → Add links in SKILL.md
+- If SKILL.md feels bloated → Move content to references
+- If you're repeating the same complex operation → Create a script
+
+**Iteration Cycle**:
+
+1. Use skill in real conversations
+2. Note friction points and gaps
+3. Refactor structure and content
+4. Test again
+
+## Common Pitfalls
+
+**Starting Too Big**
+
+- ❌ Writing 500 lines before testing
+- ✅ Start with 30-line SKILL.md, iterate
+
+**Generic Descriptions**
+
+- ❌ "Helps with coding tasks"
+- ✅ "React hooks patterns and performance optimization. Use when
+  building React components or debugging re-renders."
+
+**Bloated SKILL.md**
+
+- ❌ Including complete API docs in SKILL.md
+- ✅ Core patterns in SKILL.md, full docs in references/
+
+**Missing Triggers**
+
+- ❌ Description with no "Use when..." clause
+- ✅ Clear triggering scenarios in description
+
+**Second Person Voice**
+
+- ❌ "You should use this pattern when you need..."
+- ✅ "Use this pattern when..."
+
+## Success Criteria
+
+A well-designed skill:
+
+- ✅ Loads automatically when relevant (no manual triggering)
+- ✅ Provides exactly the context needed (not too much, not too
+  little)
+- ✅ Improves with each conversation (you notice missing pieces)
+- ✅ Saves you time (no more re-explaining the same concepts)
+
+## Tips
+
+- **Start minimal**: Better to add than to remove
+- **Test early**: Don't perfect in isolation
+- **Use real examples**: Concrete beats abstract
+- **Trust progressive disclosure**: Claude will ask for references
+  when needed
+- **Iterate based on usage**: Let real conversations drive refinement

package/dist/skills/skill-creator/references/skill-examples.md

@@ -396,7 +396,7 @@ Before considering a skill "done":
 - [ ] Detailed docs in references/
 - [ ] Scripts for repeated code
 - [ ] Assets for templates
-- [ ] Validated with `npx claude-skills validate`
+- [ ] Validated with `npx claude-skills-cli validate`
 - [ ] Tested in real conversations
 - [ ] No TODO placeholders
 - [ ] Imperative voice throughout

package/dist/validators/alignment-validator.js

@@ -0,0 +1,54 @@
+/**
+ * Alignment validation - checks description and content alignment
+ */
+import { extract_keywords } from './text-analysis.js';
+/**
+ * Analyze description and content alignment
+ */
+export function analyze_alignment(description, body) {
+    const desc_keywords = extract_keywords(description);
+    const content_keywords = extract_keywords(body);
+    const overlap = desc_keywords.filter((k) => content_keywords.includes(k));
+    const desc_only = desc_keywords.filter((k) => !content_keywords.includes(k));
+    const content_only = content_keywords
+        .filter((k) => !desc_keywords.includes(k))
+        .slice(0, 20);
+    const overlap_ratio = desc_keywords.length > 0
+        ? overlap.length / desc_keywords.length
+        : 0;
+    let severity = 'good';
+    let explanation = 'Description aligns well with content';
+    if (overlap_ratio < 0.2 && desc_keywords.length > 5) {
+        severity = 'critical';
+        explanation = `Very low keyword overlap (${Math.round(overlap_ratio * 100)}%). Description may not match skill content.`;
+    }
+    else if (overlap_ratio < 0.3 && desc_keywords.length > 5) {
+        severity = 'moderate';
+        explanation = `Low keyword overlap (${Math.round(overlap_ratio * 100)}%). Description may not accurately reflect skill content.`;
+    }
+    const keywords = {
+        description_keywords: desc_keywords,
+        content_keywords: content_keywords.slice(0, 30),
+        overlap,
+        description_only: desc_only,
+        content_only,
+    };
+    const alignment = {
+        severity,
+        description_focus: desc_keywords.slice(0, 10),
+        content_focus: content_keywords.slice(0, 10),
+        matches: overlap,
+        mismatches: desc_only,
+        explanation,
+    };
+    const warnings = [];
+    if (overlap_ratio < 0.3 && desc_keywords.length > 5) {
+        warnings.push({
+            type: 'low_overlap',
+            message: `Low keyword overlap between description and content (${Math.round(overlap_ratio * 100)}%)\n` +
+                `  → Description may not accurately reflect skill content`,
+        });
+    }
+    return { keywords, alignment, warnings };
+}
+//# sourceMappingURL=alignment-validator.js.map

package/dist/validators/alignment-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alignment-validator.js","sourceRoot":"","sources":["../../src/validators/alignment-validator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AActD;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAChC,WAAmB,EACnB,IAAY;IAEZ,MAAM,aAAa,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACpD,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAEhD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAC1C,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAC5B,CAAC;IACF,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CACrC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,CACpC,CAAC;IACF,MAAM,YAAY,GAAG,gBAAgB;SACnC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;SACzC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEf,MAAM,aAAa,GAClB,aAAa,CAAC,MAAM,GAAG,CAAC;QACvB,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM;QACvC,CAAC,CAAC,CAAC,CAAC;IAEN,IAAI,QAAQ,GAAqC,MAAM,CAAC;IACxD,IAAI,WAAW,GAAG,sCAAsC,CAAC;IAEzD,IAAI,aAAa,GAAG,GAAG,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrD,QAAQ,GAAG,UAAU,CAAC;QACtB,WAAW,GAAG,6BAA6B,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,GAAG,CAAC,8CAA8C,CAAC;IAC1H,CAAC;SAAM,IAAI,aAAa,GAAG,GAAG,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5D,QAAQ,GAAG,UAAU,CAAC;QACtB,WAAW,GAAG,wBAAwB,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,GAAG,CAAC,2DAA2D,CAAC;IAClI,CAAC;IAED,MAAM,QAAQ,GAAoB;QACjC,oBAAoB,EAAE,aAAa;QACnC,gBAAgB,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QAC/C,OAAO;QACP,gBAAgB,EAAE,SAAS;QAC3B,YAAY;KACZ,CAAC;IAEF,MAAM,SAAS,GAAsB;QACpC,QAAQ;QACR,iBAAiB,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QAC7C,aAAa,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QAC5C,OAAO,EAAE,OAAO;QAChB,UAAU,EAAE,SAAS;QACrB,WAAW;KACX,CAAC;IAEF,MAAM,QAAQ,GAAuB,EAAE,CAAC;IAExC,IAAI,aAAa,GAAG,GAAG,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrD,QAAQ,CAAC,IAAI,CAAC;YACb,IAAI,EAAE,aAAa;YACnB,OAAO,EACN,wDAAwD,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,GAAG,CAAC,MAAM;gBAC7F,0DAA0D;SAC3D,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AAC1C,CAAC"}