@compilr-dev/sdk 0.7.7 → 0.7.9

package/dist/skills/course-skills.js

@@ -0,0 +1,164 @@
+/**
+ * Course / Training Skills
+ *
+ * curriculum-design, lesson-plan, assessment-design, course-review
+ */
+import { defineSkill } from '@compilr-dev/agents';
+export const curriculumDesignSkill = defineSkill({
+    name: 'curriculum-design',
+    description: 'Define course structure — modules, learning objectives, progression',
+    prompt: `You are in CURRICULUM DESIGN MODE. Help the user structure their course.
+
+## Step 1: Course Overview
+1. Use \`curriculum_model_get\` scope: "overview" to check existing state
+2. Ask for: course title, description, target audience, prerequisites, difficulty level
+3. Save: \`curriculum_model_update\` op: "set_course_info"
+
+## Step 2: Module Breakdown
+Ask: "What are the main topics/sections of your course?"
+Help organize into 3-8 modules with logical progression.
+For each module: \`curriculum_model_update\` op: "module_add"
+
+## Step 3: Learning Objectives
+For each module, ask: "After this module, what should the student be able to DO?"
+Use Bloom's taxonomy levels:
+- Remember (define, list, recall)
+- Understand (explain, describe, summarize)
+- Apply (use, implement, solve)
+- Analyze (compare, differentiate, examine)
+- Evaluate (assess, critique, judge)
+- Create (design, build, compose)
+
+Save: \`curriculum_model_update\` op: "module_update" with learningObjectives
+
+## Step 4: Time Estimates
+Ask about total course length, then distribute across modules.
+Save: \`curriculum_model_update\` op: "module_update" with estimatedMinutes
+
+## Step 5: Generate Work Items
+Create one "Lesson" work item per module: "Develop: [module title]"
+
+## Step 6: Validation
+Run \`curriculum_model_validate\` to check completeness.
+
+## Rules
+- Interactive — one section at a time
+- The user is the subject expert, you are the curriculum designer
+- Push for specific, measurable objectives (not "understand Python" but "write a function that takes arguments and returns a value")
+- Suggest KB uploads for existing materials`,
+    tags: ['education', 'planning', 'curriculum'],
+});
+export const lessonPlanSkill = defineSkill({
+    name: 'lesson-plan',
+    description: 'Break a module into detailed lessons with types and time estimates',
+    prompt: `You are in LESSON PLAN MODE. Break a module into detailed lessons.
+
+## Step 1: Read Context
+1. \`curriculum_model_get\` scope: "modules" for overview
+2. Ask which module to plan (or plan all)
+3. Read the module's learning objectives
+
+## Step 2: Propose Lessons
+For each learning objective, propose lessons:
+- **theory** — explain concepts, principles, background
+- **demo** — show how it works (live coding, walkthrough)
+- **hands-on** — student does it themselves
+- **discussion** — reflect, discuss implications, share experiences
+- **reading** — reference material, further study
+
+Balance: aim for at least 40% hands-on/demo.
+
+## Step 3: Sequence and Time
+- Order lessons logically (concept before practice)
+- Estimate minutes per lesson
+- Total should roughly match the module's estimated time
+
+Save each: \`curriculum_model_update\` op: "lesson_add"
+
+## Step 4: Suggest Assessments
+After lessons, suggest an assessment for the module.
+Save: \`curriculum_model_update\` op: "assessment_add"
+
+## Rules
+- Every learning objective should be addressed by at least one lesson
+- Don't create theory-only modules — students need practice
+- Keep individual lessons under 45 minutes
+- Suggest where KB materials could be used`,
+    tags: ['education', 'planning', 'lessons'],
+});
+export const assessmentDesignSkill = defineSkill({
+    name: 'assessment-design',
+    description: 'Create quizzes, exercises, and projects for a module',
+    prompt: `You are in ASSESSMENT DESIGN MODE. Create assessments linked to learning objectives.
+
+## Step 1: Read Context
+1. \`curriculum_model_get\` scope: "module" with the target module
+2. Review learning objectives and existing lessons
+
+## Step 2: Choose Assessment Types
+Match assessment to objective level:
+- **quiz** — for Remember/Understand (multiple choice, true/false, short answer)
+- **exercise** — for Apply/Analyze (hands-on practice, problem solving)
+- **project** — for Evaluate/Create (open-ended, multi-step)
+- **peer-review** — students review each other's work
+- **reflection** — self-assessment, learning journal
+
+## Step 3: Design Each Assessment
+For each: title, type, description, which objectives it tests.
+Save: \`curriculum_model_update\` op: "assessment_add"
+
+## Step 4: Coverage Check
+Verify every learning objective has at least one assessment.
+Flag untested objectives.
+
+## Rules
+- Every objective should be assessed
+- Mix assessment types for variety
+- Exercises should be doable within the lesson timeframe
+- Projects can span multiple objectives`,
+    tags: ['education', 'assessment'],
+});
+export const courseReviewSkill = defineSkill({
+    name: 'course-review',
+    description: 'Review course for pedagogical quality — balance, coverage, progression',
+    prompt: `You are in COURSE REVIEW MODE. Evaluate the curriculum as a pedagogical expert.
+
+## Step 1: Load
+1. \`curriculum_model_get\` scope: "full"
+2. Run \`curriculum_model_validate\` for structural issues
+
+## Step 2: Completeness
+Check each module has:
+- Learning objectives (specific, measurable)
+- Lessons (at least 2)
+- At least one assessment
+Score: Complete / Partial / Missing
+
+## Step 3: Balance Analysis
+- Theory vs practice ratio per module (flag if >70% theory)
+- Time distribution across modules (flag if one is >2x the average)
+- Lesson type variety (flag modules with only one type)
+
+## Step 4: Progression
+- Are prerequisites respected? (easier modules before harder ones)
+- Does difficulty increase progressively?
+- Are foundational concepts taught before they're needed?
+
+## Step 5: Assessment Coverage
+- Map objectives to assessments
+- Flag objectives with no assessment
+- Flag assessments testing nothing specific
+
+## Step 6: Report
+Generate a structured review:
+- Scorecard (modules: complete/partial/missing)
+- Strengths
+- Issues (critical + recommendations)
+- Create work items for issues found
+
+## Rules
+- Be constructive — suggest fixes, don't just flag problems
+- Focus on pedagogy, not domain accuracy (user is the expert)
+- 3-5 most impactful recommendations, not a list of 20 nitpicks`,
+    tags: ['education', 'review', 'quality'],
+});

package/dist/skills/index.d.ts

@@ -1,4 +1,4 @@
 /**
  * Platform Skills — barrel export
  */
-export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, financialModelSkill, pitchOutlineSkill, businessReviewSkill, brandSetupSkill, contentStrategySkill, contentCalendarSkill, createContentSkill, contentReviewSkill, } from './platform-skills.js';
+export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, financialModelSkill, pitchOutlineSkill, businessReviewSkill, brandSetupSkill, contentStrategySkill, contentCalendarSkill, createContentSkill, contentReviewSkill, curriculumDesignSkill, lessonPlanSkill, assessmentDesignSkill, courseReviewSkill, bookOutlineSkill, characterDesignSkill, plotThreadsSkill, sceneBreakdownSkill, bookReviewSkill, } from './platform-skills.js';

package/dist/skills/index.js

@@ -1,4 +1,4 @@
 /**
  * Platform Skills — barrel export
  */
-export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, financialModelSkill, pitchOutlineSkill, businessReviewSkill, brandSetupSkill, contentStrategySkill, contentCalendarSkill, createContentSkill, contentReviewSkill, } from './platform-skills.js';
+export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, financialModelSkill, pitchOutlineSkill, businessReviewSkill, brandSetupSkill, contentStrategySkill, contentCalendarSkill, createContentSkill, contentReviewSkill, curriculumDesignSkill, lessonPlanSkill, assessmentDesignSkill, courseReviewSkill, bookOutlineSkill, characterDesignSkill, plotThreadsSkill, sceneBreakdownSkill, bookReviewSkill, } from './platform-skills.js';

package/dist/skills/platform-skills.d.ts

@@ -1,41 +1,17 @@
 /**
- * Platform Skills
+ * Platform Skills — Aggregate
  *
- * Skills that depend on platform-specific tools (backlog, workitems, documents, projects).
- * These were originally in @compilr-dev/agents and @compilr-dev/agents-coding-core
- * but belong in the SDK since they reference platform tools.
- *
- * Skills: design, sketch, prd, refine, refine-item, architecture, session-notes, build, scaffold
+ * Re-exports all domain-specific skills and provides the combined platformSkills array.
+ * Individual skill files: software-skills.ts, research-skills.ts, business-skills.ts, content-skills.ts
  */
-import { type Skill } from '@compilr-dev/agents';
-export declare const designSkill: Skill;
-export declare const refineSkill: Skill;
-export declare const sketchSkill: Skill;
-export declare const refineItemSkill: Skill;
-export declare const architectureSkill: Skill;
-export declare const prdSkill: Skill;
-export declare const sessionNotesSkill: Skill;
-export declare const buildSkill: Skill;
-export declare const scaffoldSkill: Skill;
-export declare const outlineSkill: Skill;
-export declare const literatureReviewSkill: Skill;
-export declare const draftSectionSkill: Skill;
-export declare const peerReviewSkill: Skill;
-export declare const researchScaffoldSkill: Skill;
-export declare const businessVisionSkill: Skill;
-export declare const marketAnalysisSkill: Skill;
-export declare const competitorAnalysisSkill: Skill;
-export declare const financialModelSkill: Skill;
-export declare const pitchOutlineSkill: Skill;
-export declare const businessReviewSkill: Skill;
-export declare const brandSetupSkill: Skill;
-export declare const contentStrategySkill: Skill;
-export declare const contentCalendarSkill: Skill;
-export declare const createContentSkill: Skill;
-export declare const contentReviewSkill: Skill;
+import type { Skill } from '@compilr-dev/agents';
+export { designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, } from './software-skills.js';
+export { outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, } from './research-skills.js';
+export { businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, financialModelSkill, pitchOutlineSkill, businessReviewSkill, } from './business-skills.js';
+export { brandSetupSkill, contentStrategySkill, contentCalendarSkill, createContentSkill, contentReviewSkill, } from './content-skills.js';
+export { curriculumDesignSkill, lessonPlanSkill, assessmentDesignSkill, courseReviewSkill, } from './course-skills.js';
+export { bookOutlineSkill, characterDesignSkill, plotThreadsSkill, sceneBreakdownSkill, bookReviewSkill, } from './book-skills.js';
 /**
- * All platform-specific skills (25 total).
- * These skills reference platform tools (backlog, workitems, documents, projects)
- * and belong in the SDK rather than in generic agent/coding libraries.
+ * All platform-specific skills (34 total).
  */
 export declare const platformSkills: Skill[];