Loading...
Loading...
Implementation guidance for creating individual agents in the Arcanea system with proper structure, capabilities, and integration.
npx skill4agent add frankxai/arcanea agent-implementerinterface Agent {
// Identity
id: string; // Unique kebab-case ID
name: string; // Display name
command: string; // Invocation command (/id)
// Classification
court: string; // Guardian court name
element: string; // Fire/Water/Earth/Air/Void
frequency: string; // Operating frequency
// Capabilities
specialty: string; // One-line description
capabilities: string[]; // What they can do
skills: string[]; // Available skills
triggers: string[]; // Activation keywords
// Configuration
promptTemplate: string; // System prompt template
examples: string[]; // Example outputs
parameters: ParamSchema; // Input parameters
// Metadata
version: string; // Agent version
author: string; // Creator
tier: 'free' | 'premium'; // Access level
}const ignitionAgent = {
id: "ignition",
name: "Ignition",
command: "/ignition",
court: "Draconia",
element: "fire",
frequency: "528Hz",
specialty: "Spark rapid creative ideas"
};/fire ignite/fire intensify/foundation beginYou are {name} from the {court} Court.
Frequency: {frequency} | Element: {element}
Specialty: {specialty}
Your approach:
- {Characteristic 1}
- {Characteristic 2}
- {Characteristic 3}
Task: {{task}}
Context: {{context}}
Provide your contribution as {name}:You are Ignition from the Draconia Court.
Frequency: 528Hz | Element: Fire
Specialty: Spark rapid creative ideas
Your approach:
- High-energy, passionate
- Fast generation over perfection
- Bold, unconventional ideas
- Fearless creativity
Task: {{task}}
Context: {{context}}
Ignite creative fire. Generate 10 bold, energetic ideas rapidly.
Don't self-censor. Embrace wild possibilities.triggers: [
"stuck",
"blocked",
"can't start",
"ignite",
"spark",
"rapid",
"brainstorm",
"ideas"
]parameters: {
task: {
type: "string",
required: true,
description: "What to generate ideas for"
},
count: {
type: "number",
required: false,
default: 10,
description: "Number of ideas to generate"
},
temperature: {
type: "number",
required: false,
default: 0.9,
description: "Creativity level (0.1-1.0)"
}
}// In arcanea-agents/registry.js
const AGENT_REGISTRY = {
courts: {
elemental: {
fire: {
guardian: "Draconia",
agents: [
// ... other agents
{
id: "ignition",
name: "Ignition",
// ... all properties
}
]
}
}
}
};// Test ignition agent
describe('Ignition Agent', () => {
test('generates ideas for character', async () => {
const result = await invokeAgent('ignition', {
task: 'Create a cyberpunk character'
});
expect(result.output).toContain('character');
expect(result.output.split('\n').length).toBeGreaterThan(5);
});
});{
id: "{kebab-name}",
name: "{TitleCaseName}",
command: "/{kebab-name}",
court: "Draconia",
element: "fire",
frequency: "{396|528|639|741|852|963}Hz",
specialty: "{One-line specialty}",
personality: "{Fiery, passionate, transformative}",
capabilities: ["{capability1}", "{capability2}"],
skills: ["/fire {skill1}", "/fire {skill2}"],
triggers: ["{keyword1}", "{keyword2}"],
promptTemplate: `You are {name} from the Draconia Court...
Task: {{task}}
Approach with fire: intense, passionate, transformative.
{specific_instructions}`,
examples: ["{example1}", "{example2}"]
}{
id: "{kebab-name}",
name: "{TitleCaseName}",
command: "/{kebab-name}",
court: "Leyla",
element: "water",
frequency: "{396|528|639|741|852}Hz",
specialty: "{One-line specialty}",
personality: "{Fluid, emotional, nurturing}",
capabilities: ["{capability1}", "{capability2}"],
skills: ["/flow {skill1}", "/flow {skill2}"],
triggers: ["{keyword1}", "{keyword2}"],
promptTemplate: `You are {name} from the Leyla Court...
Task: {{task}}
Approach with water: flowing, emotional, adaptive.
{specific_instructions}`,
examples: ["{example1}", "{example2}"]
}{
id: "structure",
name: "Structure",
subModes: [
{ id: "structure-architect", name: "Architect Mode" },
{ id: "structure-foundation", name: "Foundation Mode" },
{ id: "structure-refinement", name: "Refinement Mode" }
]
}{
id: "depth",
name: "Depth",
parameters: {
depth: {
type: "enum",
options: ["surface", "shallow", "deep", "abyssal"],
default: "deep"
}
}
}{
id: "relationship",
name: "Relationship",
contextWindow: 5, // Remember last 5 interactions
memory: {
type: "conversation",
persistence: "session"
}
}test('agent responds correctly', async () => {
const agent = getAgent('ignition');
const result = await agent.invoke('Brainstorm ideas');
expect(result).toBeDefined();
expect(result.output).toBeTruthy();
});test('agent integrates with conductor', async () => {
const result = await conductor.orchestrate({
agent: 'ignition',
task: 'test'
});
expect(result.success).toBe(true);
});