@almadar/skills 1.0.12 → 1.1.0

package/dist/index.d.ts

@@ -52,18 +52,22 @@ declare function writeAllSkills(skills: GeneratedSkill[], baseDir: string): void
  * Uses the orbital skill generator from the orbitals module and adds
  * domain classification, interaction models, and trait-driven UI guidance.
  *
+ * v4.0: Reduced from ~49K to ~15K by cutting std dump, schema-updates,
+ * custom-traits, and half the errors. Added render-ui design guide with
+ * pattern catalog and composition recipes.
+ *
  * @packageDocumentation
  */
 
 /**
  * Generate the kflow-orbitals skill.
  *
- * Uses the lean orbital skill generator which produces a ~90% smaller skill
- * by deriving prompts from types and using focused, minimal sections.
+ * Uses the lean orbital skill generator with minimal defaults (~15K).
+ * The design guide, top-6 errors, and enriched example are always included.
  *
  * Options:
- * - compact: false (default) - Include full std/* state machine examples (49K chars)
- * - compact: true - Exclude std/* examples for minimal size (24K chars)
+ * - compact: false (default) - Standard ~15K generation skill
+ * - compact: true - Same (compact flag preserved for API compat, no-op now)
  */
 declare function generateKflowOrbitalsSkill(compact?: boolean): GeneratedSkill;
 
@@ -101,6 +105,35 @@ declare function generateKflowOrbitalFixingSkill(): GeneratedSkill;
  */
 declare function generateDomainLanguageSkill(): GeneratedSkill;
 
+/**
+ * KFlow Design Skill Generator
+ *
+ * Generates the kflow-design skill for render-ui authoring.
+ * This is a focused ~10K skill that operates at the transition level,
+ * producing rich render-ui effects using the full pattern catalog.
+ *
+ * Unlike kflow-orbitals (which focuses on structure), this skill
+ * focuses entirely on UI design decisions: pattern selection,
+ * slot composition, layout nesting, and domain-aware styling.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Generate the kflow-design skill.
+ *
+ * Produces a focused ~10K skill for render-ui authoring.
+ * Used by the design_transition tool to produce rich UI effects.
+ */
+declare function generateKflowDesignSkill(): GeneratedSkill;
+/**
+ * Get design skill stats for comparison.
+ */
+declare function getDesignSkillStats(): {
+    lines: number;
+    chars: number;
+};
+
 /**
  * Lean Orbital Skill Generator
  *
@@ -137,7 +170,13 @@ declare function generateLeanFixingSkill$1(): string;
  * 2. Using focused, minimal guidance sections
  * 3. Avoiding verbose explanations and redundancy
  *
- * Target: <1000 lines output (vs 4000+ in original)
+ * v4: Reduced from ~49K to ~15K by:
+ * - Removing std behaviors JSON dump (21K)
+ * - Removing schema-updates (moved to fixing skill)
+ * - Removing custom-traits (moved to fixing skill)
+ * - Trimming common-errors to top 6
+ * - Replacing 380-char render-ui quickref with 2.5K design guide
+ * - Using compact decomposition and connectivity variants
  *
  * @packageDocumentation
  */
@@ -154,12 +193,19 @@ interface LeanSkillOptions {
     includeStdStateMachines?: boolean;
     /** Include schema update guidance section */
     includeSchemaUpdates?: boolean;
+    /** Include custom trait examples section */
+    includeCustomTraits?: boolean;
+    /** Error detail level: 'top6' for generation, 'full' for fixing */
+    errorLevel?: 'top6' | 'full';
+    /** Include render-ui design guide with pattern catalog and recipes */
+    includeDesignGuide?: boolean;
 }
 /**
  * Generate a lean orbital skill.
  *
- * This produces a skill that is ~75% smaller than the original while
- * containing all essential information for orbital generation.
+ * Default options produce a ~15K skill focused on generation quality.
+ * Set includeStdStateMachines/includeCustomTraits/errorLevel='full' for
+ * the larger ~49K variant used by legacy callers.
  */
 declare function generateLeanOrbitalSkill(options?: LeanSkillOptions): string;
 
@@ -192,19 +238,20 @@ declare function generateLeanFixingSkill(options?: LeanFixingSkillOptions): stri
 /**
  * Skill Generators for Builder Client
  *
- * Re-exports the 5 core skills used by the builder client:
+ * Re-exports the 6 core skills used by the builder client:
  * 1. kflow-orbitals (standard JSON generation)
  * 2. kflow-orbital-fixing (standard fixing)
  * 3. kflow-lean-orbitals (lean domain language generation)
  * 4. kflow-lean-fixing (lean fixing)
  * 5. domain-language (ODL understanding/summarization)
+ * 6. kflow-design (render-ui design for transitions)
  *
  * @packageDocumentation
  */
 
 /**
  * Generate all builder client skills.
- * These are the 5 skills actually used by the builder UI.
+ * These are the 6 skills actually used by the builder UI.
  */
 declare function generateAllBuilderSkills(): GeneratedSkill[];
 
@@ -231,9 +278,9 @@ declare function getArchitectureSection(): string;
  */
 /**
  * Get common errors section.
- * These are the most frequent mistakes made during generation.
+ * Supports tiered output: 'top6' for generation skill, 'full' for fixing skill.
  */
-declare function getCommonErrorsSection(): string;
+declare function getCommonErrorsSection(level?: 'top6' | 'full'): string;
 /**
  * Get validation error hints section.
  * Quick reference for common validation errors and fixes.
@@ -256,6 +303,16 @@ declare function getDecompositionSection(): string;
  * Get minimal decomposition checklist.
  */
 declare function getDecompositionChecklist(): string;
+/**
+ * Get compact decomposition protocol (~1,250 chars).
+ * Steps 0-6 without verbose guard examples (guards covered in S-Expr + errors).
+ */
+declare function getDecompositionCompact(): string;
+/**
+ * Get compact orbital connectivity (~750 chars).
+ * One combined example instead of three separate examples.
+ */
+declare function getConnectivityCompact(): string;
 /**
  * Get flow pattern selection guidance.
  * Maps application types to appropriate user flow patterns.
@@ -270,6 +327,23 @@ declare function getPortableOrbitalOutputSection(): string;
  */
 declare function getOrbitalConnectivitySection(): string;
 
+/**
+ * Pattern Design Guide Section
+ *
+ * Replaces the 380-char getRenderUIQuickRef() with actionable guidance
+ * on pattern selection, composition recipes, and slot strategy.
+ *
+ * Target: ~2,500 chars — focused entirely on helping the LLM produce
+ * rich, varied render-ui effects instead of defaulting to entity-table.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Get the render-ui design guide.
+ * Covers syntax, slot strategy, pattern-by-intent, and composition recipes.
+ */
+declare function getRenderUIDesignGuide(): string;
+
 /**
  * Custom Trait Guidance Section
  *
@@ -498,4 +572,4 @@ declare function getFieldTypesCompact(): string;
  */
 declare function getKeyBehaviorsReference(): string;
 
-export { type GeneratedSkill, type SkillFrontmatter, formatFrontmatter, generateAllBuilderSkills, generateDomainLanguageSkill, generateKflowOrbitalFixingSkill, generateKflowOrbitalsSkill, generateLeanFixingSkill$1 as generateLeanFixingSkill, generateLeanFixingSkill as generateLeanFixingSkillFull, generateLeanOrbitalSkill$1 as generateLeanOrbitalSkill, generateLeanOrbitalSkill as generateLeanOrbitalSkillFull, getArchitectureSection, getAssetRefSection, getCommonErrorsSection, getCommonFixPatternsSection, getCompletionRulesSection, getContextUsageCompact, getContextUsageSection, getCustomTraitCompact, getCustomTraitSection, getDecompositionChecklist, getDecompositionSection, getDesignErrorsCompact, getDesignErrorsSection, getEfficiencySection, getFieldTypesCompact, getFixingWorkflowSection, getFlowPatternSection, getFullOrbitalPrompt, getGameAsOrbitalsSection, getGameEntityTemplatesSection, getGamePatternsSection, getGameTraitsSection, getGameTypesSection, getIconLibraryCompact, getIconLibrarySection, getKeyBehaviorsReference, getMinimalTypeReference, getMultiFileSection, getOrbitalConnectivitySection, getOrbitalDecompositionPrompt, getOverGenerationSection, getPatternTypesCompact, getPortableOrbitalOutputSection, getRenderUIQuickRef, getRequirementsDecomposePrompt, getRequirementsTraitPrompt, getSExprQuickRef, getSchemaUpdateCompact, getSchemaUpdateSection, getUsesImportCompact, getUsesImportSection, getValidationHintsSection, writeAllSkills, writeSkill };
+export { type GeneratedSkill, type SkillFrontmatter, formatFrontmatter, generateAllBuilderSkills, generateDomainLanguageSkill, generateKflowDesignSkill, generateKflowOrbitalFixingSkill, generateKflowOrbitalsSkill, generateLeanFixingSkill$1 as generateLeanFixingSkill, generateLeanFixingSkill as generateLeanFixingSkillFull, generateLeanOrbitalSkill$1 as generateLeanOrbitalSkill, generateLeanOrbitalSkill as generateLeanOrbitalSkillFull, getArchitectureSection, getAssetRefSection, getCommonErrorsSection, getCommonFixPatternsSection, getCompletionRulesSection, getConnectivityCompact, getContextUsageCompact, getContextUsageSection, getCustomTraitCompact, getCustomTraitSection, getDecompositionChecklist, getDecompositionCompact, getDecompositionSection, getDesignErrorsCompact, getDesignErrorsSection, getDesignSkillStats, getEfficiencySection, getFieldTypesCompact, getFixingWorkflowSection, getFlowPatternSection, getFullOrbitalPrompt, getGameAsOrbitalsSection, getGameEntityTemplatesSection, getGamePatternsSection, getGameTraitsSection, getGameTypesSection, getIconLibraryCompact, getIconLibrarySection, getKeyBehaviorsReference, getMinimalTypeReference, getMultiFileSection, getOrbitalConnectivitySection, getOrbitalDecompositionPrompt, getOverGenerationSection, getPatternTypesCompact, getPortableOrbitalOutputSection, getRenderUIDesignGuide, getRenderUIQuickRef, getRequirementsDecomposePrompt, getRequirementsTraitPrompt, getSExprQuickRef, getSchemaUpdateCompact, getSchemaUpdateSection, getUsesImportCompact, getUsesImportSection, getValidationHintsSection, writeAllSkills, writeSkill };