diff --git a/README.md b/README.md index c0e9475e..6d592785 100644 --- a/README.md +++ b/README.md @@ -419,9 +419,9 @@ skillkit cicd init # CI/CD templates
-Plus 34 more +Plus 35 more -Amp, Antigravity, Augment Code, Bolt, Clawdbot, Cline, CodeBuddy, CodeGPT, CommandCode, Continue, Crush, Droid, Factory, Goose, Kilo Code, Kiro CLI, Lovable, MCPJam, Mux, Neovate, OpenClaw, OpenHands, Pi, PlayCode, Qoder, Qwen, Replit Agent, Roo Code, Tabby, Tabnine, Trae, Vercel, Zencoder, Universal. +Amp, Antigravity, Augment Code, Bolt, Clawdbot, Cline, CodeBuddy, CodeGPT, CommandCode, Continue, Crush, Droid, Factory, Goose, Hermes Agent, Kilo Code, Kiro CLI, Lovable, MCPJam, Mux, Neovate, OpenClaw, OpenHands, Pi, PlayCode, Qoder, Qwen, Replit Agent, Roo Code, Tabby, Tabnine, Trae, Vercel, Zencoder, Universal.
[Full agent details](https://skillkit.sh/docs/agents) diff --git a/packages/agents/src/__tests__/adapters.test.ts b/packages/agents/src/__tests__/adapters.test.ts index 8e6c10dc..b9de26e7 100644 --- a/packages/agents/src/__tests__/adapters.test.ts +++ b/packages/agents/src/__tests__/adapters.test.ts @@ -35,10 +35,10 @@ const ALL_AGENTS = AgentType.options; describe('Agent Adapters', () => { describe('getAllAdapters', () => { - it('should return all 45 registered adapters', () => { + it('should return all 46 registered adapters', () => { const adapters = getAllAdapters(); expect(adapters).toBeInstanceOf(Array); - expect(adapters.length).toBe(45); + expect(adapters.length).toBe(46); }); it('should include common agents', () => { @@ -140,4 +140,43 @@ describe('Agent Adapters', () => { expect(typeof agent).toBe('string'); }); }); + + describe('HermesAdapter', () => { + it('should generate valid XML config', () => { + const adapter = getAdapter('hermes'); + const mockSkills = [ + { name: 'test-skill', description: 'Testing', enabled: true, path: '', location: 'project' } + ]; + const config = adapter.generateConfig(mockSkills as any); + + expect(config).toContain('test-skill'); + expect(config).toContain('SKILLS_TABLE_START'); + }); + + it('should parse skill names from XML correctly within markers', () => { + const adapter = getAdapter('hermes'); + const xml = ` + +git-ops +`; + const names = adapter.parseConfig(xml); + expect(names).toContain('git-ops'); + }); + + it('should ignore tags outside of sync markers', () => { + const adapter = getAdapter('hermes'); + const xml = ` +save-the-world + +git-ops + +internal-id`; + const names = adapter.parseConfig(xml); + expect(names).toHaveLength(1); + expect(names).toContain('git-ops'); + expect(names).not.toContain('save-the-world'); + expect(names).not.toContain('internal-id'); + }); + }); }); diff --git a/packages/agents/src/generic.ts b/packages/agents/src/generic.ts index 610a3461..210b71eb 100644 --- a/packages/agents/src/generic.ts +++ b/packages/agents/src/generic.ts @@ -33,6 +33,7 @@ const AGENT_DISPLAY_NAMES: Partial> = { 'tabnine': 'Tabnine', 'codegpt': 'CodeGPT', 'playcode-agent': 'PlayCode Agent', + 'hermes': 'Hermes', }; export class GenericAgentAdapter implements AgentAdapter { diff --git a/packages/agents/src/hermes.ts b/packages/agents/src/hermes.ts new file mode 100644 index 00000000..951ff325 --- /dev/null +++ b/packages/agents/src/hermes.ts @@ -0,0 +1,93 @@ +import { existsSync } from 'node:fs'; +import { join } from 'node:path'; +import { homedir } from 'node:os'; +import type { AgentAdapter } from './base.js'; +import { createSkillXml } from './base.js'; +import type { Skill, AgentType } from '@skillkit/core'; +import { AGENT_CONFIG } from '@skillkit/core'; + +const config = AGENT_CONFIG.hermes; + +/** + * Hermes Agent Adapter + * + * Hermes Agent is an advanced AI agent with support for XML-based skills. + * It uses AGENTS.md for instructions and ~/.hermes/skills/ for global skills. + */ +export class HermesAdapter implements AgentAdapter { + readonly type: AgentType = 'hermes'; + readonly name = 'Hermes Agent'; + readonly skillsDir = config.skillsDir; + readonly configFile = config.configFile; + + generateConfig(skills: Skill[]): string { + const enabledSkills = skills.filter(s => s.enabled); + + if (enabledSkills.length === 0) { + return ''; + } + + const skillsXml = enabledSkills.map(createSkillXml).join('\n\n'); + + return ` + +## Available Skills + + + +When users ask you to perform tasks, check if any of the available skills below can help complete the task more effectively. Skills provide specialized capabilities and domain knowledge. + +How to use skills: +- Invoke: \`skillkit read \` or \`npx skillkit read \` +- The skill content will load with detailed instructions on how to complete the task +- Base directory provided in output for resolving bundled resources (references/, scripts/, assets/) + +Usage notes: +- Only use skills listed in below +- Do not invoke a skill that is already loaded in your context +- Each skill invocation is stateless + + + + +${skillsXml} + + + + +`; + } + + parseConfig(content: string): string[] { + const startMarker = ''; + const endMarker = ''; + const startIndex = content.indexOf(startMarker); + const endIndex = content.indexOf(endMarker); + + if (startIndex === -1 || endIndex === -1) { + return []; + } + + const scopedContent = content.substring(startIndex + startMarker.length, endIndex); + const skillNames: string[] = []; + const skillRegex = /([^<]+)<\/name>/g; + let match; + + while ((match = skillRegex.exec(scopedContent)) !== null) { + skillNames.push(match[1].trim()); + } + + return skillNames; + } + + getInvokeCommand(skillName: string): string { + return `skillkit read ${skillName}`; + } + + async isDetected(): Promise { + const projectHermes = join(process.cwd(), '.hermes'); + const globalHermes = join(homedir(), '.hermes'); + + return existsSync(projectHermes) || existsSync(globalHermes); + } +} diff --git a/packages/agents/src/index.ts b/packages/agents/src/index.ts index d1ab1c84..4e08a514 100644 --- a/packages/agents/src/index.ts +++ b/packages/agents/src/index.ts @@ -19,6 +19,7 @@ import { RooAdapter } from './roo.js'; import { TraeAdapter } from './trae.js'; import { WindsurfAdapter } from './windsurf.js'; import { UniversalAdapter } from './universal.js'; +import { HermesAdapter } from './hermes.js'; import { GenericAgentAdapter } from './generic.js'; export * from './base.js'; @@ -41,6 +42,7 @@ export * from './roo.js'; export * from './trae.js'; export * from './windsurf.js'; export * from './universal.js'; +export * from './hermes.js'; export * from './generic.js'; // Agent features @@ -92,6 +94,7 @@ const adapters: Record = { tabnine: new GenericAgentAdapter('tabnine'), codegpt: new GenericAgentAdapter('codegpt'), 'playcode-agent': new GenericAgentAdapter('playcode-agent'), + hermes: new HermesAdapter(), }; export function getAdapter(type: AgentType): AgentAdapter { @@ -160,6 +163,7 @@ export async function detectAgent(): Promise { 'tabnine', 'codegpt', 'playcode-agent', + 'hermes', 'universal', ]; diff --git a/packages/cli/src/commands/sync.ts b/packages/cli/src/commands/sync.ts index dd94f498..493d6bda 100644 --- a/packages/cli/src/commands/sync.ts +++ b/packages/cli/src/commands/sync.ts @@ -214,6 +214,10 @@ function updateConfigContent(existing: string, newConfig: string, agentType: Age start: '', end: '', }, + hermes: { + start: '', + end: '', + }, }; const agentMarkers = markers[agentType] || markers.universal; diff --git a/packages/core/src/agent-config.ts b/packages/core/src/agent-config.ts index 41579b96..b3b75932 100644 --- a/packages/core/src/agent-config.ts +++ b/packages/core/src/agent-config.ts @@ -477,6 +477,16 @@ export const AGENT_CONFIG: Record = { usesFrontmatter: true, supportsAutoDiscovery: true, }, + + // Hermes Agent + hermes: { + skillsDir: '.hermes/skills', + configFile: 'AGENTS.md', + globalSkillsDir: '~/.hermes/skills', + configFormat: 'xml', + usesFrontmatter: true, + supportsAutoDiscovery: true, + }, }; /** diff --git a/packages/core/src/agents/types.ts b/packages/core/src/agents/types.ts index f7ea4a65..2f3c3799 100644 --- a/packages/core/src/agents/types.ts +++ b/packages/core/src/agents/types.ts @@ -264,6 +264,7 @@ export const AGENT_DISCOVERY_PATHS: Record = { 'tabnine': ['.tabnine/agents'], 'codegpt': ['.codegpt/agents'], 'playcode-agent': ['.playcode/agents'], + 'hermes': ['.hermes/agents'], }; /** @@ -324,6 +325,7 @@ export const ALL_AGENT_DISCOVERY_PATHS = [ '.tabnine/agents', '.codegpt/agents', '.playcode/agents', + '.hermes/agents', ]; /** @@ -375,4 +377,5 @@ export const CUSTOM_AGENT_FORMAT_MAP: Record = { 'tabnine': 'universal', 'codegpt': 'universal', 'playcode-agent': 'universal', + 'hermes': 'claude-agent', }; diff --git a/packages/core/src/commands/generator.ts b/packages/core/src/commands/generator.ts index f2f01e21..0fc32e11 100644 --- a/packages/core/src/commands/generator.ts +++ b/packages/core/src/commands/generator.ts @@ -332,6 +332,13 @@ const AGENT_FORMATS: Record = { supportsSlashCommands: false, supportsCommandFiles: true, }, + hermes: { + agent: 'hermes', + extension: '.md', + directory: '.hermes/commands', + supportsSlashCommands: true, + supportsCommandFiles: true, + }, }; /** @@ -593,6 +600,7 @@ export class CommandGenerator { case 'amp': case 'roo': case 'kiro-cli': + case 'hermes': return this.generateClaudeCommands(commands); case 'cursor': diff --git a/packages/core/src/context/sync.ts b/packages/core/src/context/sync.ts index 9eb1a715..45c11467 100644 --- a/packages/core/src/context/sync.ts +++ b/packages/core/src/context/sync.ts @@ -286,6 +286,7 @@ export class ContextSync { const commonDirs = [ '.claude/skills', '.cursor/skills', + '.hermes/skills', '.agent/skills', 'skills', ]; diff --git a/packages/core/src/primer/types.ts b/packages/core/src/primer/types.ts index 6f121e76..4c53dd58 100644 --- a/packages/core/src/primer/types.ts +++ b/packages/core/src/primer/types.ts @@ -203,4 +203,10 @@ export const AGENT_INSTRUCTION_TEMPLATES: Record = { 'tabnine': 'skill-md', 'codegpt': 'skill-md', 'playcode-agent': 'external', + 'hermes': 'skill-md', }; /** diff --git a/packages/core/src/types.ts b/packages/core/src/types.ts index e288c99c..f5b8bda6 100644 --- a/packages/core/src/types.ts +++ b/packages/core/src/types.ts @@ -46,6 +46,7 @@ export const AgentType = z.enum([ "tabnine", "codegpt", "playcode-agent", + "hermes", ]); export type AgentType = z.infer; diff --git a/packages/mcp/src/tools.ts b/packages/mcp/src/tools.ts index 7c8df4d7..eebff592 100644 --- a/packages/mcp/src/tools.ts +++ b/packages/mcp/src/tools.ts @@ -185,6 +185,7 @@ const AGENT_DIR_MAP: Record = { 'claude-code': ['.claude/skills'], 'cursor': ['.cursor/skills'], 'codex': ['.codex/skills'], 'gemini-cli': ['.gemini/skills'], 'opencode': ['.opencode/skills', '.config/opencode/skills'], 'antigravity': ['.antigravity/skills'], 'amp': ['.amp/skills'], 'clawdbot': ['.clawdbot/skills'], + 'hermes': ['.hermes/skills'], 'openclaw': ['.openclaw/skills', '.openclaw/workspace/skills', 'skills'], 'github-copilot': ['.github/skills'], 'goose': ['.goose/skills'], 'kilo': ['.kilocode/skills'], 'kiro-cli': ['.kiro/skills'], 'roo': ['.roo/skills'], 'trae': ['.trae/skills'], 'windsurf': ['.windsurf/skills', '.codeium/windsurf/skills'], diff --git a/src/agents/hermes.ts b/src/agents/hermes.ts new file mode 100644 index 00000000..81b6ebda --- /dev/null +++ b/src/agents/hermes.ts @@ -0,0 +1,87 @@ +import { existsSync } from 'node:fs'; +import { join } from 'node:path'; +import { homedir } from 'node:os'; +import type { AgentAdapter } from './base.js'; +import { createSkillXml } from './base.js'; +import type { Skill, AgentType } from '../core/types.js'; + +/** + * Hermes Agent Adapter (Legacy) + */ +export class HermesAdapter implements AgentAdapter { + readonly type: AgentType = 'hermes'; + readonly name = 'Hermes Agent'; + readonly skillsDir = '.hermes/skills'; + readonly configFile = 'AGENTS.md'; + + generateConfig(skills: Skill[]): string { + const enabledSkills = skills.filter(s => s.enabled); + + if (enabledSkills.length === 0) { + return ''; + } + + const skillsXml = enabledSkills.map(createSkillXml).join('\n\n'); + + return ` + +## Available Skills + + + +When users ask you to perform tasks, check if any of the available skills below can help complete the task more effectively. Skills provide specialized capabilities and domain knowledge. + +How to use skills: +- Invoke: \`skillkit read \` or \`npx skillkit read \` +- The skill content will load with detailed instructions on how to complete the task +- Base directory provided in output for resolving bundled resources (references/, scripts/, assets/) + +Usage notes: +- Only use skills listed in below +- Do not invoke a skill that is already loaded in your context +- Each skill invocation is stateless + + + + +${skillsXml} + + + + +`; + } + + parseConfig(content: string): string[] { + const startMarker = ''; + const endMarker = ''; + const startIndex = content.indexOf(startMarker); + const endIndex = content.indexOf(endMarker); + + if (startIndex === -1 || endIndex === -1) { + return []; + } + + const scopedContent = content.substring(startIndex + startMarker.length, endIndex); + const skillNames: string[] = []; + const skillRegex = /([^<]+)<\/name>/g; + let match; + + while ((match = skillRegex.exec(scopedContent)) !== null) { + skillNames.push(match[1].trim()); + } + + return skillNames; + } + + getInvokeCommand(skillName: string): string { + return `skillkit read ${skillName}`; + } + + async isDetected(): Promise { + const projectHermes = join(process.cwd(), '.hermes'); + const globalHermes = join(homedir(), '.hermes'); + + return existsSync(projectHermes) || existsSync(globalHermes); + } +} diff --git a/src/agents/index.ts b/src/agents/index.ts index f6096099..ab4af3a5 100644 --- a/src/agents/index.ts +++ b/src/agents/index.ts @@ -17,6 +17,7 @@ import { RooAdapter } from './roo.js'; import { TraeAdapter } from './trae.js'; import { WindsurfAdapter } from './windsurf.js'; import { UniversalAdapter } from './universal.js'; +import { HermesAdapter } from './hermes.js'; export * from './base.js'; export * from './claude-code.js'; @@ -55,6 +56,7 @@ const adapters: Record = { trae: new TraeAdapter(), windsurf: new WindsurfAdapter(), universal: new UniversalAdapter(), + hermes: new HermesAdapter(), }; export function getAdapter(type: AgentType): AgentAdapter { @@ -83,6 +85,7 @@ export async function detectAgent(): Promise { 'roo', 'trae', 'windsurf', + 'hermes', 'universal', ]; diff --git a/src/agents/windsurf.ts b/src/agents/windsurf.ts index 45c1dd77..38e87e24 100644 --- a/src/agents/windsurf.ts +++ b/src/agents/windsurf.ts @@ -9,7 +9,7 @@ export class WindsurfAdapter implements AgentAdapter { readonly type: AgentType = 'windsurf'; readonly name = 'Windsurf'; readonly skillsDir = '.windsurf/skills'; - readonly configFile = 'AGENTS.md'; + readonly configFile = '.windsurf/rules/skills.md'; readonly globalSkillsDir = join(homedir(), '.codeium', 'windsurf', 'skills'); generateConfig(skills: Skill[]): string { diff --git a/src/core/types.ts b/src/core/types.ts index c5bd1218..735f5f5f 100644 --- a/src/core/types.ts +++ b/src/core/types.ts @@ -18,6 +18,7 @@ export const AgentType = z.enum([ 'trae', 'windsurf', 'universal', + 'hermes', ]); export type AgentType = z.infer; diff --git a/tests/agents.test.ts b/tests/agents.test.ts index 28ae2190..6e0d8c75 100644 --- a/tests/agents.test.ts +++ b/tests/agents.test.ts @@ -140,13 +140,22 @@ describe('agents', () => { expect(adapter.type).toBe('windsurf'); expect(adapter.name).toBe('Windsurf'); expect(adapter.skillsDir).toBe('.windsurf/skills'); + expect(adapter.configFile).toBe('.windsurf/rules/skills.md'); + }); + + it('should return adapter for hermes', () => { + const adapter = getAdapter('hermes'); + expect(adapter.type).toBe('hermes'); + expect(adapter.name).toBe('Hermes Agent'); + expect(adapter.skillsDir).toBe('.hermes/skills'); + expect(adapter.configFile).toBe('AGENTS.md'); }); }); describe('getAllAdapters', () => { - it('should return all 17 adapters', () => { + it('should return all 18 adapters', () => { const adapters = getAllAdapters(); - expect(adapters.length).toBe(17); + expect(adapters.length).toBe(18); expect(adapters.map(a => a.type)).toContain('claude-code'); expect(adapters.map(a => a.type)).toContain('cursor'); expect(adapters.map(a => a.type)).toContain('universal');