@compilr-dev/sdk 0.7.6 → 0.7.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.ts +1 -1
- package/dist/index.js +1 -1
- package/dist/project-types/action-meta.js +6 -0
- package/dist/project-types/skill-meta.js +6 -0
- package/dist/skills/index.d.ts +1 -1
- package/dist/skills/index.js +1 -1
- package/dist/skills/platform-skills.d.ts +6 -1
- package/dist/skills/platform-skills.js +187 -1
- package/package.json +1 -1
package/dist/index.d.ts
CHANGED
|
@@ -61,7 +61,7 @@ export type { AskUserQuestion, AskUserInput, AskUserResult, AskUserHandler, AskU
|
|
|
61
61
|
export { createPlatformTools, createProjectTools, createWorkItemTools, createDocumentTools, createPlanTools, createBacklogTools, createAnchorTools, createArtifactTools, createEpisodeTools, ProjectAnchorStore, } from './platform/index.js';
|
|
62
62
|
export type { ProjectAnchorStoreConfig } from './platform/index.js';
|
|
63
63
|
export { STEP_ORDER, GUIDED_STEP_CRITERIA, getNextStep, isValidTransition, getStepCriteria, formatStepDisplay, getStepNumber, } from './platform/index.js';
|
|
64
|
-
export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, financialModelSkill, pitchOutlineSkill, businessReviewSkill, } from './skills/index.js';
|
|
64
|
+
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 './skills/index.js';
|
|
65
65
|
export { ACTION_REGISTRY, getActionsForContext, getActionById, resolveActionPrompt, buildContextSummary, getSuggestedRole, } from './actions/index.js';
|
|
66
66
|
export type { ActionContext, ActionDefinition } from './actions/index.js';
|
|
67
67
|
export { PROJECT_TYPES, getProjectTypeConfig, getEnrichedProjectTypeConfig, getProjectTypesByCategory, generalConfig, softwareConfig, researchConfig, businessPlanConfig, contentConfig, techDocsConfig, courseConfig, ACTION_META_REGISTRY, SKILL_META_REGISTRY, resolveActionMeta, getSkillMeta, getAllSkillMeta, } from './project-types/index.js';
|
package/dist/index.js
CHANGED
|
@@ -139,7 +139,7 @@ export { STEP_ORDER, GUIDED_STEP_CRITERIA, getNextStep, isValidTransition, getSt
|
|
|
139
139
|
// =============================================================================
|
|
140
140
|
// Platform Skills (platform-specific prompt expansions)
|
|
141
141
|
// =============================================================================
|
|
142
|
-
export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, financialModelSkill, pitchOutlineSkill, businessReviewSkill, } from './skills/index.js';
|
|
142
|
+
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 './skills/index.js';
|
|
143
143
|
// =============================================================================
|
|
144
144
|
// Contextual Actions (skill invocations with context)
|
|
145
145
|
// =============================================================================
|
|
@@ -58,6 +58,12 @@ export const ACTION_META_REGISTRY = {
|
|
|
58
58
|
'business-vision': { id: 'business-vision', label: 'Vision', icon: 'Target', description: 'Define your business' },
|
|
59
59
|
'market-analysis': { id: 'market-analysis', label: 'Market', icon: 'TrendingUp', description: 'Analyze the market' },
|
|
60
60
|
'competitor-analysis': { id: 'competitor-analysis', label: 'Competitors', icon: 'Swords', description: 'Map competition' },
|
|
61
|
+
// ── Content & Marketing actions ───────────────────────────────────────────
|
|
62
|
+
'brand-setup': { id: 'brand-setup', label: 'Brand', icon: 'Palette', description: 'Set up brand identity' },
|
|
63
|
+
'content-strategy': { id: 'content-strategy', label: 'Strategy', icon: 'Target', description: 'Define pillars' },
|
|
64
|
+
'content-calendar': { id: 'content-calendar', label: 'Calendar', icon: 'Calendar', description: 'Plan content' },
|
|
65
|
+
'create-content': { id: 'create-content', label: 'Create', icon: 'PenTool', description: 'Write content' },
|
|
66
|
+
'content-review': { id: 'content-review', label: 'Review', icon: 'CheckCircle', description: 'Check quality' },
|
|
61
67
|
'financial-model': { id: 'financial-model', label: 'Financials', icon: 'DollarSign', description: 'Build projections' },
|
|
62
68
|
'pitch-outline': { id: 'pitch-outline', label: 'Pitch', icon: 'Rocket', description: 'Structure a pitch' },
|
|
63
69
|
'business-review': { id: 'business-review', label: 'Review', icon: 'ShieldCheck', description: 'Validate the plan' },
|
|
@@ -113,6 +113,12 @@ export const SKILL_META_REGISTRY = {
|
|
|
113
113
|
'financial-model': { id: 'financial-model', label: 'Financial Model', description: 'Build revenue and cost projections', icon: 'DollarSign', category: 'analysis' },
|
|
114
114
|
'pitch-outline': { id: 'pitch-outline', label: 'Pitch Outline', description: 'Structure an investor pitch', icon: 'Rocket', category: 'planning' },
|
|
115
115
|
'business-review': { id: 'business-review', label: 'Business Review', description: 'Validate the business plan', icon: 'ShieldCheck', category: 'analysis' },
|
|
116
|
+
// ── Content & Marketing Skills ───────────────────────────────────────────
|
|
117
|
+
'brand-setup': { id: 'brand-setup', label: 'Brand Setup', description: 'Define brand identity, voice, and visual guidelines', icon: 'Palette', category: 'planning' },
|
|
118
|
+
'content-strategy': { id: 'content-strategy', label: 'Content Strategy', description: 'Define content pillars and cadence', icon: 'Target', category: 'planning' },
|
|
119
|
+
'content-calendar': { id: 'content-calendar', label: 'Content Calendar', description: 'Plan content for a period', icon: 'Calendar', category: 'planning' },
|
|
120
|
+
'create-content': { id: 'create-content', label: 'Create Content', description: 'Write copy and visual brief', icon: 'PenTool', category: 'development' },
|
|
121
|
+
'content-review': { id: 'content-review', label: 'Content Review', description: 'Review for brand consistency', icon: 'CheckCircle', category: 'analysis' },
|
|
116
122
|
// ── Builtin Skills (agents library) ──────────────────────────────────────
|
|
117
123
|
'code-review': {
|
|
118
124
|
id: 'code-review',
|
package/dist/skills/index.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Platform Skills — barrel export
|
|
3
3
|
*/
|
|
4
|
-
export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, financialModelSkill, pitchOutlineSkill, businessReviewSkill, } from './platform-skills.js';
|
|
4
|
+
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';
|
package/dist/skills/index.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Platform Skills — barrel export
|
|
3
3
|
*/
|
|
4
|
-
export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, financialModelSkill, pitchOutlineSkill, businessReviewSkill, } from './platform-skills.js';
|
|
4
|
+
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';
|
|
@@ -28,8 +28,13 @@ export declare const competitorAnalysisSkill: Skill;
|
|
|
28
28
|
export declare const financialModelSkill: Skill;
|
|
29
29
|
export declare const pitchOutlineSkill: Skill;
|
|
30
30
|
export declare const businessReviewSkill: Skill;
|
|
31
|
+
export declare const brandSetupSkill: Skill;
|
|
32
|
+
export declare const contentStrategySkill: Skill;
|
|
33
|
+
export declare const contentCalendarSkill: Skill;
|
|
34
|
+
export declare const createContentSkill: Skill;
|
|
35
|
+
export declare const contentReviewSkill: Skill;
|
|
31
36
|
/**
|
|
32
|
-
* All platform-specific skills (
|
|
37
|
+
* All platform-specific skills (25 total).
|
|
33
38
|
* These skills reference platform tools (backlog, workitems, documents, projects)
|
|
34
39
|
* and belong in the SDK rather than in generic agent/coding libraries.
|
|
35
40
|
*/
|
|
@@ -1748,10 +1748,191 @@ Write report to a project document.
|
|
|
1748
1748
|
tags: ['business', 'review', 'validation'],
|
|
1749
1749
|
});
|
|
1750
1750
|
// =============================================================================
|
|
1751
|
+
// Content & Marketing Skills
|
|
1752
|
+
// =============================================================================
|
|
1753
|
+
export const brandSetupSkill = defineSkill({
|
|
1754
|
+
name: 'brand-setup',
|
|
1755
|
+
description: 'Define brand identity, visual guidelines, voice, audience, and content strategy',
|
|
1756
|
+
prompt: `You are in BRAND SETUP MODE. Guide the user through building their Brand Model step by step.
|
|
1757
|
+
|
|
1758
|
+
## Step 1: Brand Identity
|
|
1759
|
+
1. Use \`brand_model_get\` with scope: "overview" to check existing state
|
|
1760
|
+
2. Ask for: brand name, tagline, 2-3 sentence description
|
|
1761
|
+
3. Save: \`brand_model_update\` op: "set_brand_identity"
|
|
1762
|
+
|
|
1763
|
+
## Step 2: Values & Mission
|
|
1764
|
+
Ask for 3-5 core values and an optional mission statement.
|
|
1765
|
+
Save: \`brand_model_update\` op: "set_brand_identity" with values and mission
|
|
1766
|
+
|
|
1767
|
+
## Step 3: Color Palette
|
|
1768
|
+
Ask for brand colors with their roles (primary, secondary, accent, background, text).
|
|
1769
|
+
For each: \`brand_model_update\` op: "add_color", color: { role, name, hex }
|
|
1770
|
+
|
|
1771
|
+
## Step 4: Font Hierarchy
|
|
1772
|
+
Ask what fonts the brand uses. Map to roles: title, subtitle, heading, subheading, body, caption.
|
|
1773
|
+
For each: \`brand_model_update\` op: "add_font", font: { role, family, weight }
|
|
1774
|
+
|
|
1775
|
+
## Step 5: Visual Styles
|
|
1776
|
+
Ask about photography style, graphic/illustration style, icon style.
|
|
1777
|
+
Save each: \`brand_model_update\` op: "set_photography_style" / "set_graphic_style" / "set_icon_style", style_value: "..."
|
|
1778
|
+
|
|
1779
|
+
## Step 6: Brand Voice
|
|
1780
|
+
Ask about:
|
|
1781
|
+
- Tone (formal, casual, playful, authoritative, empathetic, technical, inspirational)
|
|
1782
|
+
- Persona ("a knowledgeable friend who explains without jargon")
|
|
1783
|
+
- Words/phrases to USE and AVOID
|
|
1784
|
+
- 1-3 writing samples that represent the brand voice
|
|
1785
|
+
Save: \`brand_model_update\` op: "set_voice", voice: { tone, persona, doUse, dontUse, writingSamples }
|
|
1786
|
+
|
|
1787
|
+
## Step 7: Audience Personas
|
|
1788
|
+
For each target persona: name, role/title, pain points, platforms they use.
|
|
1789
|
+
Save: \`brand_model_update\` op: "add_persona", persona: { name, role, painPoints, platforms }
|
|
1790
|
+
|
|
1791
|
+
## Step 8: Platforms
|
|
1792
|
+
For each platform: id (linkedin, instagram, twitter, blog, newsletter), formats, cadence, tone adjustment.
|
|
1793
|
+
Save: \`brand_model_update\` op: "add_platform", platform: { id, active: true, formats, postsPerWeek, toneDelta }
|
|
1794
|
+
|
|
1795
|
+
## Step 9: Content Pillars
|
|
1796
|
+
Define 3-5 thematic pillars with example topics and weight %.
|
|
1797
|
+
Save: \`brand_model_update\` op: "add_pillar", pillar: { name, description, exampleTopics, weight }
|
|
1798
|
+
|
|
1799
|
+
## Step 10: Validation
|
|
1800
|
+
Run \`brand_model_validate\` to check completeness. Report gaps and ask if user wants to fill them.
|
|
1801
|
+
|
|
1802
|
+
## Rules
|
|
1803
|
+
- This is INTERACTIVE — ask one section at a time, don't overwhelm
|
|
1804
|
+
- If the user already has brand guidelines, they can paste them and you extract the data
|
|
1805
|
+
- Skip sections the user doesn't have answers for — they can complete later
|
|
1806
|
+
- After each section, confirm what was saved before moving on`,
|
|
1807
|
+
tags: ['content', 'brand', 'setup'],
|
|
1808
|
+
});
|
|
1809
|
+
export const contentStrategySkill = defineSkill({
|
|
1810
|
+
name: 'content-strategy',
|
|
1811
|
+
description: 'Define or refine content pillars and per-platform cadence',
|
|
1812
|
+
prompt: `You are in CONTENT STRATEGY MODE. Help the user plan their content approach.
|
|
1813
|
+
|
|
1814
|
+
## Step 1: Assess
|
|
1815
|
+
1. Use \`brand_model_get\` scope: "strategy" for existing pillars
|
|
1816
|
+
2. Use \`brand_model_get\` scope: "audience" for personas and platforms
|
|
1817
|
+
|
|
1818
|
+
## Step 2: Define/Refine Pillars
|
|
1819
|
+
- What are the 3-5 themes you want to publish about?
|
|
1820
|
+
- For each: name, description, example topics, weight (% of content calendar)
|
|
1821
|
+
- Weights should sum to ~100%
|
|
1822
|
+
|
|
1823
|
+
Save: \`brand_model_update\` op: "add_pillar" or "update_pillar"
|
|
1824
|
+
|
|
1825
|
+
## Step 3: Platform Cadence
|
|
1826
|
+
For each active platform, confirm or set posting frequency.
|
|
1827
|
+
Save: \`brand_model_update\` op: "update_platform", updates: { postsPerWeek }
|
|
1828
|
+
|
|
1829
|
+
## Step 4: Generate Work Items
|
|
1830
|
+
Create initial content piece work items based on pillars and cadence.`,
|
|
1831
|
+
tags: ['content', 'strategy', 'planning'],
|
|
1832
|
+
});
|
|
1833
|
+
export const contentCalendarSkill = defineSkill({
|
|
1834
|
+
name: 'content-calendar',
|
|
1835
|
+
description: 'Generate content piece work items for a specific period',
|
|
1836
|
+
prompt: `You are in CONTENT CALENDAR MODE. Plan content for a specific period.
|
|
1837
|
+
|
|
1838
|
+
## Step 1: Assess
|
|
1839
|
+
1. Read Brand Model: pillars, platforms, cadence
|
|
1840
|
+
2. Ask: "What period? (e.g., next 2 weeks, this month)"
|
|
1841
|
+
|
|
1842
|
+
## Step 2: Generate Calendar
|
|
1843
|
+
- Distribute pieces across pillars per their weights
|
|
1844
|
+
- Respect per-platform cadence (postsPerWeek)
|
|
1845
|
+
- Generate topic ideas for each piece
|
|
1846
|
+
- Balance content types (carousel, article, thread, etc.)
|
|
1847
|
+
|
|
1848
|
+
## Step 3: Create Work Items
|
|
1849
|
+
For each content piece:
|
|
1850
|
+
- Type: "feature" (displayed as "Content Piece")
|
|
1851
|
+
- Title: "[Platform] Topic Title"
|
|
1852
|
+
- Description: pillar, format, key points to cover
|
|
1853
|
+
- Priority: based on timing
|
|
1854
|
+
|
|
1855
|
+
Present the calendar as a table before creating work items.`,
|
|
1856
|
+
tags: ['content', 'calendar', 'planning'],
|
|
1857
|
+
});
|
|
1858
|
+
export const createContentSkill = defineSkill({
|
|
1859
|
+
name: 'create-content',
|
|
1860
|
+
description: 'Write copy and generate visual brief for a content piece',
|
|
1861
|
+
prompt: `You are in CONTENT CREATION MODE. Create a complete content piece.
|
|
1862
|
+
|
|
1863
|
+
## Step 1: Read Context
|
|
1864
|
+
1. \`brand_model_get\` scope: "voice" — tone, persona, do/don't
|
|
1865
|
+
2. \`brand_model_get\` scope: "visual" — colors, fonts, styles
|
|
1866
|
+
3. \`brand_model_get\` scope: "audience" — persona and platform conventions
|
|
1867
|
+
4. Read the work item for topic, platform, format details
|
|
1868
|
+
|
|
1869
|
+
## Step 2: Write Copy
|
|
1870
|
+
Based on the platform and format:
|
|
1871
|
+
- **Headline** — attention-grabbing, on-brand
|
|
1872
|
+
- **Body** — main content, matching brand voice
|
|
1873
|
+
- **CTA** — clear call-to-action
|
|
1874
|
+
- **Hashtags** — platform-appropriate
|
|
1875
|
+
- **Slides** (for carousels) — per-slide heading + body
|
|
1876
|
+
|
|
1877
|
+
## Step 3: Visual Brief
|
|
1878
|
+
Generate a detailed visual brief using Brand Model:
|
|
1879
|
+
- Layout description (format, dimensions)
|
|
1880
|
+
- Color usage (which brand colors where)
|
|
1881
|
+
- Font usage (which font roles for which text)
|
|
1882
|
+
- Image direction (photography style, subject, mood)
|
|
1883
|
+
- Key text elements (text that must appear in the visual)
|
|
1884
|
+
|
|
1885
|
+
## Step 4: Assemble
|
|
1886
|
+
Write everything as structured markdown in the work item description.
|
|
1887
|
+
|
|
1888
|
+
## Rules
|
|
1889
|
+
- ALWAYS read the Brand Model voice section before writing
|
|
1890
|
+
- Never use words from the "don't use" list
|
|
1891
|
+
- Adapt tone per platform (use toneDelta if defined)
|
|
1892
|
+
- The visual brief should be specific enough for a designer to execute`,
|
|
1893
|
+
tags: ['content', 'creation', 'writing'],
|
|
1894
|
+
});
|
|
1895
|
+
export const contentReviewSkill = defineSkill({
|
|
1896
|
+
name: 'content-review',
|
|
1897
|
+
description: 'Review content for voice consistency, brand alignment, and platform conventions',
|
|
1898
|
+
prompt: `You are in CONTENT REVIEW MODE. Review a content piece as the brand's quality gate.
|
|
1899
|
+
|
|
1900
|
+
## Step 1: Read References
|
|
1901
|
+
1. \`brand_model_get\` scope: "voice" — tone, do/don't, persona
|
|
1902
|
+
2. \`brand_model_get\` scope: "visual" — brand visual guidelines
|
|
1903
|
+
3. Read the content piece (work item description)
|
|
1904
|
+
|
|
1905
|
+
## Step 2: Voice Check
|
|
1906
|
+
- Does the tone match the brand persona?
|
|
1907
|
+
- Are any "don't use" words present?
|
|
1908
|
+
- Is the language appropriate for the target platform?
|
|
1909
|
+
|
|
1910
|
+
## Step 3: Brand Alignment Check
|
|
1911
|
+
- Does the visual brief use correct brand colors?
|
|
1912
|
+
- Are font roles assigned correctly?
|
|
1913
|
+
- Does image direction match the photography/graphic style?
|
|
1914
|
+
|
|
1915
|
+
## Step 4: Platform Check
|
|
1916
|
+
- Character limits respected?
|
|
1917
|
+
- Hashtag count appropriate?
|
|
1918
|
+
- Format matches platform best practices?
|
|
1919
|
+
|
|
1920
|
+
## Step 5: Report
|
|
1921
|
+
- List issues found (voice, brand, platform)
|
|
1922
|
+
- Create revision work items for significant issues
|
|
1923
|
+
- If clean, mark as reviewed
|
|
1924
|
+
|
|
1925
|
+
## Rules
|
|
1926
|
+
- Be specific about what's wrong and how to fix it
|
|
1927
|
+
- Reference the Brand Model section that the issue violates
|
|
1928
|
+
- Don't rewrite the content — flag issues for the creator to fix`,
|
|
1929
|
+
tags: ['content', 'review', 'quality'],
|
|
1930
|
+
});
|
|
1931
|
+
// =============================================================================
|
|
1751
1932
|
// Aggregate export
|
|
1752
1933
|
// =============================================================================
|
|
1753
1934
|
/**
|
|
1754
|
-
* All platform-specific skills (
|
|
1935
|
+
* All platform-specific skills (25 total).
|
|
1755
1936
|
* These skills reference platform tools (backlog, workitems, documents, projects)
|
|
1756
1937
|
* and belong in the SDK rather than in generic agent/coding libraries.
|
|
1757
1938
|
*/
|
|
@@ -1776,4 +1957,9 @@ export const platformSkills = [
|
|
|
1776
1957
|
financialModelSkill,
|
|
1777
1958
|
pitchOutlineSkill,
|
|
1778
1959
|
businessReviewSkill,
|
|
1960
|
+
brandSetupSkill,
|
|
1961
|
+
contentStrategySkill,
|
|
1962
|
+
contentCalendarSkill,
|
|
1963
|
+
createContentSkill,
|
|
1964
|
+
contentReviewSkill,
|
|
1779
1965
|
];
|