Merge pull request #114 from RUFFY-369/feat/hermes-agent-native-support

feat: add Hermes agent adapter (Native Hermes Support)

Author: rohitg00

README.md

@@ -419,9 +419,9 @@ skillkit cicd init               # CI/CD templates
 </details>
 
 <details>
-<summary><b>Plus 34 more</b></summary>
+<summary><b>Plus 35 more</b></summary>
 
-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.
 </details>
 
 [Full agent details](https://skillkit.sh/docs/agents)

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('<skills_system');
+      expect(config).toContain('<name>test-skill</name>');
+      expect(config).toContain('SKILLS_TABLE_START');
+    });
+
+    it('should parse skill names from XML correctly within markers', () => {
+      const adapter = getAdapter('hermes');
+      const xml = `
+<!-- SKILLS_TABLE_START -->
+<available_skills><skill><name>git-ops</name></skill></available_skills>
+<!-- SKILLS_TABLE_END -->`;
+      const names = adapter.parseConfig(xml);
+      expect(names).toContain('git-ops');
+    });
+
+    it('should ignore <name> tags outside of sync markers', () => {
+      const adapter = getAdapter('hermes');
+      const xml = `
+<mission><name>save-the-world</name></mission>
+<!-- SKILLS_TABLE_START -->
+<available_skills><skill><name>git-ops</name></skill></available_skills>
+<!-- SKILLS_TABLE_END -->
+<footer_meta><name>internal-id</name></footer_meta>`;
+      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');
+    });
+  });
 });

packages/agents/src/generic.ts

@@ -33,6 +33,7 @@ const AGENT_DISPLAY_NAMES: Partial<Record<AgentType, string>> = {
   'tabnine': 'Tabnine',
   'codegpt': 'CodeGPT',
   'playcode-agent': 'PlayCode Agent',
+  'hermes': 'Hermes',
 };
 
 export class GenericAgentAdapter implements AgentAdapter {

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 `<skills_system priority="1">
+
+## Available Skills
+
+<!-- SKILLS_TABLE_START -->
+<usage>
+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 <skill-name>\` or \`npx skillkit read <skill-name>\`
+- 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 <available_skills> below
+- Do not invoke a skill that is already loaded in your context
+- Each skill invocation is stateless
+</usage>
+
+<available_skills>
+
+${skillsXml}
+
+</available_skills>
+<!-- SKILLS_TABLE_END -->
+
+</skills_system>`;
+  }
+
+  parseConfig(content: string): string[] {
+    const startMarker = '<!-- SKILLS_TABLE_START -->';
+    const endMarker = '<!-- SKILLS_TABLE_END -->';
+    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>([^<]+)<\/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<boolean> {
+    const projectHermes = join(process.cwd(), '.hermes');
+    const globalHermes = join(homedir(), '.hermes');
+
+    return existsSync(projectHermes) || existsSync(globalHermes);
+  }
+}

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<AgentType, AgentAdapter> = {
   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<AgentType> {
     'tabnine',
     'codegpt',
     'playcode-agent',
+    'hermes',
     'universal',
   ];
 

packages/cli/src/commands/sync.ts

@@ -214,6 +214,10 @@ function updateConfigContent(existing: string, newConfig: string, agentType: Age
       start: '<!-- SKILLKIT_SKILLS_START -->',
       end: '<!-- SKILLKIT_SKILLS_END -->',
     },
+    hermes: {
+      start: '<!-- SKILLS_TABLE_START -->',
+      end: '<!-- SKILLS_TABLE_END -->',
+    },
   };
 
   const agentMarkers = markers[agentType] || markers.universal;

packages/core/src/agent-config.ts

@@ -477,6 +477,16 @@ export const AGENT_CONFIG: Record<AgentType, AgentDirectoryConfig> = {
     usesFrontmatter: true,
     supportsAutoDiscovery: true,
   },
+
+  // Hermes Agent
+  hermes: {
+    skillsDir: '.hermes/skills',
+    configFile: 'AGENTS.md',
+    globalSkillsDir: '~/.hermes/skills',
+    configFormat: 'xml',
+    usesFrontmatter: true,
+    supportsAutoDiscovery: true,
+  },
 };
 
 /**

packages/core/src/agents/types.ts

@@ -264,6 +264,7 @@ export const AGENT_DISCOVERY_PATHS: Record<AgentType, string[]> = {
   '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<AgentType, AgentFormatCategory> = {
   'tabnine': 'universal',
   'codegpt': 'universal',
   'playcode-agent': 'universal',
+  'hermes': 'claude-agent',
 };

packages/core/src/commands/generator.ts

@@ -332,6 +332,13 @@ const AGENT_FORMATS: Record<AgentType, AgentCommandFormat> = {
     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':

packages/core/src/context/sync.ts

@@ -286,6 +286,7 @@ export class ContextSync {
     const commonDirs = [
       '.claude/skills',
       '.cursor/skills',
+      '.hermes/skills',
       '.agent/skills',
       'skills',
     ];