@almadar/skills 1.0.0

package/LICENSE

@@ -0,0 +1,72 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:             Almadar FZE
+Licensed Work:        KFlow Builder / Almadar
+                      The Licensed Work is (c) 2025-2026 Almadar FZE.
+Additional Use Grant: You may make production use of the Licensed Work for
+                      non-commercial purposes and for internal evaluation.
+                      Production use for commercial purposes requires a
+                      commercial license from the Licensor.
+Change Date:          2030-02-01
+Change License:       Apache License, Version 2.0
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+---
+
+License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+ADDITIONAL TERMS:
+
+Documentation (builder/packages/website/docs/) is licensed under CC BY 4.0.
+
+TRADEMARKS:
+
+"Orbital", "KFlow", "Almadar", and the Almadar logo are trademarks of
+Almadar FZE. You may not use these trademarks without prior written
+permission from Almadar FZE.
+
+For licensing inquiries: licensing@almadar.io

package/README.md

@@ -0,0 +1,238 @@
+# @almadar/skills
+
+AI skill generators and prompts for Orbital schema generation.
+
+## Overview
+
+This package provides the core skills used by the KFlow Builder client to generate and fix Orbital schemas using AI agents.
+
+## Core Skills
+
+### 1. kflow-orbitals (Standard Generation)
+Generate complete Orbital schemas using JSON output with the Orbital Unit composition model.
+
+### 2. kflow-orbital-fixing (Standard Fixing)
+Fix compilation errors, validation errors, and schema issues using orbital-aware fixing.
+
+### 3. kflow-lean-orbitals (Lean Generation)
+Generate schemas using Domain Language output (~5x fewer tokens than JSON).
+
+### 4. kflow-lean-fixing (Lean Fixing)
+Fix validation errors using Domain Language output.
+
+### 5. domain-language
+Understand, generate, and summarize Orbital Domain Language (ODL).
+
+## Installation
+
+```bash
+pnpm add @almadar/skills
+```
+
+## Usage
+
+### As a Library
+
+```typescript
+import {
+  generateKflowOrbitalsSkill,
+  generateKflowOrbitalFixingSkill,
+  generateDomainLanguageSkill,
+  generateLeanOrbitalSkill,
+  generateLeanFixingSkill,
+  generateAllBuilderSkills
+} from '@almadar/skills';
+
+// Generate a single skill
+const skill = generateKflowOrbitalsSkill();
+console.log(skill.frontmatter); // { name, description, allowedTools, version }
+console.log(skill.content);     // Full skill markdown content
+
+// Generate all builder skills
+const allSkills = generateAllBuilderSkills();
+```
+
+### CLI Scripts
+
+This package includes several npm scripts for managing skills:
+
+#### Generate Skills
+
+```bash
+# Generate all skills to .skills/ directory
+pnpm generate
+
+# List available skills
+pnpm generate:list
+
+# Preview a specific skill
+pnpm generate:preview kflow-orbitals
+```
+
+#### Install to .deepagents
+
+```bash
+# Install skills to ~/.deepagents/kflow/skills/
+pnpm install:skills
+
+# Check installation status
+pnpm install:check
+
+# Clean and reinstall
+pnpm install:clean
+```
+
+#### Validation
+
+```bash
+# Validate all generated skills
+pnpm validate
+```
+
+#### Development
+
+```bash
+# Sync skills to builder (for monorepo development)
+pnpm sync
+
+# Dry run - show what would be synced
+pnpm sync:dry
+
+# Clean generated files
+pnpm clean
+```
+
+## Development Status
+
+✅ **Refactored and Building Successfully**
+
+### Architecture
+
+This package now follows a clean architecture:
+
+- **Keeps**: Only skill-sections (11 reusable guidance sections)
+- **Imports**: Everything else from @almadar/* packages
+- **Inlines**: Lean-specific constants for domain language skills
+
+### Package Size
+
+- **Before**: ~60 prompt files, 16,321 lines
+- **After**: 11 skill-section files, ~4,000 lines
+- **Reduction**: Deleted 12,316 lines, added 729 lines
+
+### Build Status
+
+✅ **ESM Build**: Working (90.68 KB)
+✅ **TypeScript Declarations**: Working (11.86 KB)
+✅ **Source Maps**: Working (134.71 KB)
+
+Build with: `pnpm build` (requires dependencies to be built first)
+
+### Dependencies
+
+```json
+{
+  "@almadar/core": "workspace:*",      // Types, schemas
+  "@almadar/patterns": "workspace:*",  // Pattern registry + helpers
+  "@almadar/std": "workspace:*"        // Standard library behaviors
+}
+```
+
+### Helper Functions Added
+
+**In @almadar/patterns:**
+- `getPatternsGroupedByCategory()` - Group patterns by category
+- `getPatternPropsCompact()` - Generate compact props table
+- `getPatternActionsRef()` - Generate action props reference
+- `generatePatternDescription()` - Auto-generate from metadata
+
+**In @almadar/skills:**
+- `helpers.ts` - Generate prompts from @almadar/std and @almadar/core
+
+### Remaining TODOs
+
+1. ~~Fix TypeScript declaration generation~~ ✅ **DONE**
+2. ~~Add CLI scripts for skill management~~ ✅ **DONE**
+3. Test all 5 skills generate correctly from builder
+4. Add comprehensive tests for skill generation
+
+### Build Notes
+
+- Run `pnpm build --filter "@almadar/skills"` from workspace root for best results
+- Direct `pnpm build` in package directory also works once dependencies are built
+- TypeScript declarations successfully generate with proper workspace dependency resolution
+
+## Scripts Reference
+
+| Script | Description |
+|--------|-------------|
+| `pnpm build` | Build the package (ESM + TypeScript declarations) |
+| `pnpm build:watch` | Build in watch mode |
+| `pnpm typecheck` | Run TypeScript type checking |
+| `pnpm generate` | Generate all skills to `.skills/` directory |
+| `pnpm generate:list` | List all available skills |
+| `pnpm generate:preview NAME` | Preview a specific skill |
+| `pnpm install:skills` | Install skills to `~/.deepagents/kflow/skills/` |
+| `pnpm install:check` | Check installation status |
+| `pnpm install:clean` | Clean and reinstall skills |
+| `pnpm validate` | Validate all generated skills |
+| `pnpm sync` | Sync skills to builder (monorepo only) |
+| `pnpm sync:dry` | Dry run sync (show what would change) |
+| `pnpm clean` | Remove generated files and build output |
+
+## Workflow Examples
+
+### Generate and Install Skills Locally
+
+```bash
+cd packages/almadar-skills
+pnpm build
+pnpm generate
+pnpm install:skills
+```
+
+### Development Workflow (Monorepo)
+
+```bash
+# Make changes to skill-sections or generators
+pnpm build
+pnpm generate
+pnpm validate
+
+# Sync to builder for testing
+pnpm sync
+
+# Check what would be synced first
+pnpm sync:dry
+```
+
+### Check Installed Skills
+
+```bash
+pnpm install:check
+```
+
+Output:
+```
+🔍 Checking installation...
+
+✅ Directories exist
+   /Users/you/.deepagents/kflow/skills
+
+📚 Installed skills (5):
+   ✅ kflow-orbitals
+   ✅ kflow-orbital-fixing
+   ✅ kflow-lean-orbitals
+   ✅ kflow-lean-fixing
+   ✅ domain-language
+```
+
+## Dependencies
+
+- `@almadar/core` - Core schema types
+- `@almadar/patterns` - Pattern registry
+- `@almadar/std` - Standard library
+
+## License
+
+MIT