mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-04-29 01:31:41 +00:00
Adds a Skills Hub page to the documentation site with browsable/searchable catalog of all skills (built-in, optional, and community from cached hub indexes). - Python extraction script (website/scripts/extract-skills.py) parses SKILL.md frontmatter and hub index caches into skills.json - React page (website/src/pages/skills/) with search, category filtering, source filtering, and expandable skill cards - CI workflow updated to run extraction before Docusaurus build - Deploy trigger expanded to include skills/ and optional-skills/ changes Authored by @IAvecilla
582 lines
19 KiB
TypeScript
582 lines
19 KiB
TypeScript
import React, { useState, useMemo, useCallback, useRef, useEffect } from "react";
|
|
import Layout from "@theme/Layout";
|
|
import skills from "../../data/skills.json";
|
|
import styles from "./styles.module.css";
|
|
|
|
interface Skill {
|
|
name: string;
|
|
description: string;
|
|
category: string;
|
|
categoryLabel: string;
|
|
source: string;
|
|
tags: string[];
|
|
platforms: string[];
|
|
author: string;
|
|
version: string;
|
|
}
|
|
|
|
const allSkills: Skill[] = skills as Skill[];
|
|
|
|
const CATEGORY_ICONS: Record<string, string> = {
|
|
apple: "\u{f179}",
|
|
"autonomous-ai-agents": "\u{1F916}",
|
|
blockchain: "\u{26D3}",
|
|
communication: "\u{1F4AC}",
|
|
creative: "\u{1F3A8}",
|
|
"data-science": "\u{1F4CA}",
|
|
devops: "\u{2699}",
|
|
dogfood: "\u{1F436}",
|
|
domain: "\u{1F310}",
|
|
email: "\u{2709}",
|
|
feeds: "\u{1F4E1}",
|
|
gaming: "\u{1F3AE}",
|
|
gifs: "\u{1F3AC}",
|
|
github: "\u{1F4BB}",
|
|
health: "\u{2764}",
|
|
"inference-sh": "\u{26A1}",
|
|
leisure: "\u{2615}",
|
|
mcp: "\u{1F50C}",
|
|
media: "\u{1F3B5}",
|
|
migration: "\u{1F4E6}",
|
|
mlops: "\u{1F9EA}",
|
|
"note-taking": "\u{1F4DD}",
|
|
productivity: "\u{2705}",
|
|
"red-teaming": "\u{1F6E1}",
|
|
research: "\u{1F50D}",
|
|
security: "\u{1F512}",
|
|
"smart-home": "\u{1F3E0}",
|
|
"social-media": "\u{1F4F1}",
|
|
"software-development": "\u{1F4BB}",
|
|
translation: "\u{1F30D}",
|
|
other: "\u{1F4E6}",
|
|
};
|
|
|
|
const SOURCE_CONFIG: Record<
|
|
string,
|
|
{ label: string; color: string; bg: string; border: string; icon: string }
|
|
> = {
|
|
"built-in": {
|
|
label: "Built-in",
|
|
color: "#4ade80",
|
|
bg: "rgba(74, 222, 128, 0.08)",
|
|
border: "rgba(74, 222, 128, 0.2)",
|
|
icon: "\u{2713}",
|
|
},
|
|
optional: {
|
|
label: "Optional",
|
|
color: "#fbbf24",
|
|
bg: "rgba(251, 191, 36, 0.08)",
|
|
border: "rgba(251, 191, 36, 0.2)",
|
|
icon: "\u{2B50}",
|
|
},
|
|
Anthropic: {
|
|
label: "Anthropic",
|
|
color: "#d4845a",
|
|
bg: "rgba(212, 132, 90, 0.08)",
|
|
border: "rgba(212, 132, 90, 0.2)",
|
|
icon: "\u{25C6}",
|
|
},
|
|
LobeHub: {
|
|
label: "LobeHub",
|
|
color: "#60a5fa",
|
|
bg: "rgba(96, 165, 250, 0.08)",
|
|
border: "rgba(96, 165, 250, 0.2)",
|
|
icon: "\u{25CB}",
|
|
},
|
|
"Claude Marketplace": {
|
|
label: "Marketplace",
|
|
color: "#a78bfa",
|
|
bg: "rgba(167, 139, 250, 0.08)",
|
|
border: "rgba(167, 139, 250, 0.2)",
|
|
icon: "\u{25A0}",
|
|
},
|
|
};
|
|
|
|
const SOURCE_ORDER = ["all", "built-in", "optional", "Anthropic", "LobeHub", "Claude Marketplace"];
|
|
|
|
function highlightMatch(text: string, query: string): React.ReactNode {
|
|
if (!query || !text) return text;
|
|
const idx = text.toLowerCase().indexOf(query.toLowerCase());
|
|
if (idx === -1) return text;
|
|
return (
|
|
<>
|
|
{text.slice(0, idx)}
|
|
<mark className={styles.highlight}>{text.slice(idx, idx + query.length)}</mark>
|
|
{text.slice(idx + query.length)}
|
|
</>
|
|
);
|
|
}
|
|
|
|
function SkillCard({
|
|
skill,
|
|
query,
|
|
expanded,
|
|
onToggle,
|
|
onCategoryClick,
|
|
onTagClick,
|
|
style,
|
|
}: {
|
|
skill: Skill;
|
|
query: string;
|
|
expanded: boolean;
|
|
onToggle: () => void;
|
|
onCategoryClick: (cat: string) => void;
|
|
onTagClick: (tag: string) => void;
|
|
style?: React.CSSProperties;
|
|
}) {
|
|
const src = SOURCE_CONFIG[skill.source] || SOURCE_CONFIG["optional"];
|
|
const icon = CATEGORY_ICONS[skill.category] || "\u{1F4E6}";
|
|
|
|
return (
|
|
<div
|
|
className={`${styles.card} ${expanded ? styles.cardExpanded : ""}`}
|
|
onClick={onToggle}
|
|
style={style}
|
|
>
|
|
<div className={styles.cardAccent} style={{ background: src.color }} />
|
|
|
|
<div className={styles.cardInner}>
|
|
<div className={styles.cardTop}>
|
|
<span className={styles.cardIcon}>{icon}</span>
|
|
<div className={styles.cardTitleGroup}>
|
|
<h3 className={styles.cardTitle}>
|
|
{highlightMatch(skill.name, query)}
|
|
</h3>
|
|
<span
|
|
className={styles.sourcePill}
|
|
style={{
|
|
color: src.color,
|
|
background: src.bg,
|
|
borderColor: src.border,
|
|
}}
|
|
>
|
|
{src.icon} {src.label}
|
|
</span>
|
|
</div>
|
|
</div>
|
|
|
|
<p className={`${styles.cardDesc} ${expanded ? styles.cardDescFull : ""}`}>
|
|
{highlightMatch(skill.description || "No description available.", query)}
|
|
</p>
|
|
|
|
<div className={styles.cardMeta}>
|
|
<button
|
|
className={styles.catButton}
|
|
onClick={(e) => {
|
|
e.stopPropagation();
|
|
onCategoryClick(skill.category);
|
|
}}
|
|
title={`Filter by ${skill.categoryLabel}`}
|
|
>
|
|
{skill.categoryLabel || skill.category}
|
|
</button>
|
|
{skill.platforms?.map((p) => (
|
|
<span key={p} className={styles.platformPill}>
|
|
{p === "macos" ? "\u{F8FF} macOS" : p === "linux" ? "\u{1F427} Linux" : p}
|
|
</span>
|
|
))}
|
|
</div>
|
|
|
|
{expanded && (
|
|
<div className={styles.cardDetail}>
|
|
{skill.tags?.length > 0 && (
|
|
<div className={styles.tagRow}>
|
|
{skill.tags.map((tag) => (
|
|
<button
|
|
key={tag}
|
|
className={styles.tagPill}
|
|
onClick={(e) => {
|
|
e.stopPropagation();
|
|
onTagClick(tag);
|
|
}}
|
|
>
|
|
{tag}
|
|
</button>
|
|
))}
|
|
</div>
|
|
)}
|
|
{skill.author && (
|
|
<div className={styles.authorRow}>
|
|
<span className={styles.authorLabel}>Author</span>
|
|
<span className={styles.authorValue}>{skill.author}</span>
|
|
</div>
|
|
)}
|
|
{skill.version && (
|
|
<div className={styles.authorRow}>
|
|
<span className={styles.authorLabel}>Version</span>
|
|
<span className={styles.authorValue}>{skill.version}</span>
|
|
</div>
|
|
)}
|
|
<div className={styles.installHint}>
|
|
<code>hermes skills install {skill.name}</code>
|
|
</div>
|
|
</div>
|
|
)}
|
|
</div>
|
|
</div>
|
|
);
|
|
}
|
|
|
|
function StatCard({ value, label, color }: { value: number; label: string; color: string }) {
|
|
return (
|
|
<div className={styles.stat}>
|
|
<span className={styles.statValue} style={{ color }}>
|
|
{value}
|
|
</span>
|
|
<span className={styles.statLabel}>{label}</span>
|
|
</div>
|
|
);
|
|
}
|
|
|
|
const PAGE_SIZE = 60;
|
|
|
|
export default function SkillsDashboard() {
|
|
const [search, setSearch] = useState("");
|
|
const [sourceFilter, setSourceFilter] = useState("all");
|
|
const [categoryFilter, setCategoryFilter] = useState("all");
|
|
const [expandedCard, setExpandedCard] = useState<string | null>(null);
|
|
const [visibleCount, setVisibleCount] = useState(PAGE_SIZE);
|
|
const [sidebarOpen, setSidebarOpen] = useState(false);
|
|
const searchRef = useRef<HTMLInputElement>(null);
|
|
const gridRef = useRef<HTMLDivElement>(null);
|
|
|
|
useEffect(() => {
|
|
const handler = (e: KeyboardEvent) => {
|
|
if (e.key === "/" && document.activeElement?.tagName !== "INPUT") {
|
|
e.preventDefault();
|
|
searchRef.current?.focus();
|
|
}
|
|
if (e.key === "Escape") {
|
|
searchRef.current?.blur();
|
|
setExpandedCard(null);
|
|
}
|
|
};
|
|
window.addEventListener("keydown", handler);
|
|
return () => window.removeEventListener("keydown", handler);
|
|
}, []);
|
|
|
|
const sources = useMemo(() => {
|
|
const set = new Set(allSkills.map((s) => s.source));
|
|
return SOURCE_ORDER.filter((s) => s === "all" || set.has(s));
|
|
}, []);
|
|
|
|
const categoryEntries = useMemo(() => {
|
|
const pool =
|
|
sourceFilter === "all"
|
|
? allSkills
|
|
: allSkills.filter((s) => s.source === sourceFilter);
|
|
const map = new Map<string, { label: string; count: number }>();
|
|
for (const s of pool) {
|
|
const key = s.category || "uncategorized";
|
|
const existing = map.get(key);
|
|
if (existing) {
|
|
existing.count++;
|
|
} else {
|
|
map.set(key, {
|
|
label: s.categoryLabel || s.category || "Uncategorized",
|
|
count: 1,
|
|
});
|
|
}
|
|
}
|
|
return Array.from(map.entries())
|
|
.sort((a, b) => b[1].count - a[1].count)
|
|
.map(([key, { label, count }]) => ({ key, label, count }));
|
|
}, [sourceFilter]);
|
|
|
|
const filtered = useMemo(() => {
|
|
const q = search.toLowerCase().trim();
|
|
return allSkills.filter((s) => {
|
|
if (sourceFilter !== "all" && s.source !== sourceFilter) return false;
|
|
if (categoryFilter !== "all" && s.category !== categoryFilter) return false;
|
|
if (q) {
|
|
const haystack = [s.name, s.description, s.categoryLabel, s.author, ...(s.tags || [])]
|
|
.join(" ")
|
|
.toLowerCase();
|
|
return haystack.includes(q);
|
|
}
|
|
return true;
|
|
});
|
|
}, [search, sourceFilter, categoryFilter]);
|
|
|
|
useEffect(() => {
|
|
setVisibleCount(PAGE_SIZE);
|
|
setExpandedCard(null);
|
|
}, [search, sourceFilter, categoryFilter]);
|
|
|
|
const visible = filtered.slice(0, visibleCount);
|
|
const hasMore = visibleCount < filtered.length;
|
|
|
|
const handleSourceChange = useCallback(
|
|
(src: string) => {
|
|
setSourceFilter(src);
|
|
setCategoryFilter("all");
|
|
},
|
|
[]
|
|
);
|
|
|
|
const handleCategoryClick = useCallback((cat: string) => {
|
|
setCategoryFilter(cat);
|
|
gridRef.current?.scrollIntoView({ behavior: "smooth", block: "start" });
|
|
setSidebarOpen(false);
|
|
}, []);
|
|
|
|
const handleTagClick = useCallback((tag: string) => {
|
|
setSearch(tag);
|
|
searchRef.current?.focus();
|
|
}, []);
|
|
|
|
const clearAll = useCallback(() => {
|
|
setSearch("");
|
|
setSourceFilter("all");
|
|
setCategoryFilter("all");
|
|
}, []);
|
|
|
|
return (
|
|
<Layout
|
|
title="Skills Hub"
|
|
description="Browse all skills and plugins available for Hermes Agent"
|
|
>
|
|
<div className={styles.page}>
|
|
<header className={styles.hero}>
|
|
<div className={styles.heroGlow} />
|
|
<div className={styles.heroContent}>
|
|
<p className={styles.heroEyebrow}>Hermes Agent</p>
|
|
<h1 className={styles.heroTitle}>Skills Hub</h1>
|
|
<p className={styles.heroSub}>
|
|
Discover, search, and install from{" "}
|
|
<strong className={styles.heroAccent}>{allSkills.length}</strong> skills
|
|
across {sources.length - 1} registries
|
|
</p>
|
|
|
|
<div className={styles.statsRow}>
|
|
<StatCard
|
|
value={allSkills.filter((s) => s.source === "built-in").length}
|
|
label="Built-in"
|
|
color="#4ade80"
|
|
/>
|
|
<StatCard
|
|
value={allSkills.filter((s) => s.source === "optional").length}
|
|
label="Optional"
|
|
color="#fbbf24"
|
|
/>
|
|
<StatCard
|
|
value={
|
|
allSkills.filter(
|
|
(s) => s.source !== "built-in" && s.source !== "optional"
|
|
).length
|
|
}
|
|
label="Community"
|
|
color="#60a5fa"
|
|
/>
|
|
<StatCard
|
|
value={new Set(allSkills.map((s) => s.category)).size}
|
|
label="Categories"
|
|
color="#a78bfa"
|
|
/>
|
|
</div>
|
|
</div>
|
|
</header>
|
|
|
|
<div className={styles.controlsBar}>
|
|
<div className={styles.searchWrap}>
|
|
<svg className={styles.searchIcon} viewBox="0 0 20 20" fill="currentColor" width="18" height="18">
|
|
<path
|
|
fillRule="evenodd"
|
|
d="M8 4a4 4 0 100 8 4 4 0 000-8zM2 8a6 6 0 1110.89 3.476l4.817 4.817a1 1 0 01-1.414 1.414l-4.816-4.816A6 6 0 012 8z"
|
|
clipRule="evenodd"
|
|
/>
|
|
</svg>
|
|
<input
|
|
ref={searchRef}
|
|
type="text"
|
|
placeholder='Search skills... (press "/" to focus)'
|
|
value={search}
|
|
onChange={(e) => setSearch(e.target.value)}
|
|
className={styles.searchInput}
|
|
/>
|
|
{search && (
|
|
<button className={styles.clearBtn} onClick={() => setSearch("")}>
|
|
<svg viewBox="0 0 20 20" fill="currentColor" width="16" height="16">
|
|
<path
|
|
fillRule="evenodd"
|
|
d="M10 18a8 8 0 100-16 8 8 0 000 16zM8.707 7.293a1 1 0 00-1.414 1.414L8.586 10l-1.293 1.293a1 1 0 101.414 1.414L10 11.414l1.293 1.293a1 1 0 001.414-1.414L11.414 10l1.293-1.293a1 1 0 00-1.414-1.414L10 8.586 8.707 7.293z"
|
|
clipRule="evenodd"
|
|
/>
|
|
</svg>
|
|
</button>
|
|
)}
|
|
</div>
|
|
|
|
<div className={styles.sourcePills}>
|
|
{sources.map((src) => {
|
|
const active = sourceFilter === src;
|
|
const conf = SOURCE_CONFIG[src];
|
|
const count =
|
|
src === "all"
|
|
? allSkills.length
|
|
: allSkills.filter((s) => s.source === src).length;
|
|
return (
|
|
<button
|
|
key={src}
|
|
className={`${styles.srcPill} ${active ? styles.srcPillActive : ""}`}
|
|
onClick={() => handleSourceChange(src)}
|
|
style={
|
|
active && conf
|
|
? ({
|
|
"--pill-color": conf.color,
|
|
"--pill-bg": conf.bg,
|
|
"--pill-border": conf.border,
|
|
} as React.CSSProperties)
|
|
: undefined
|
|
}
|
|
>
|
|
{src === "all" ? "All" : conf?.label || src}
|
|
<span className={styles.srcCount}>{count}</span>
|
|
</button>
|
|
);
|
|
})}
|
|
</div>
|
|
</div>
|
|
|
|
<div className={styles.layout}>
|
|
<button
|
|
className={styles.sidebarToggle}
|
|
onClick={() => setSidebarOpen(!sidebarOpen)}
|
|
>
|
|
<svg viewBox="0 0 20 20" fill="currentColor" width="18" height="18">
|
|
<path
|
|
fillRule="evenodd"
|
|
d="M3 5a1 1 0 011-1h12a1 1 0 110 2H4a1 1 0 01-1-1zM3 10a1 1 0 011-1h12a1 1 0 110 2H4a1 1 0 01-1-1zM3 15a1 1 0 011-1h6a1 1 0 110 2H4a1 1 0 01-1-1z"
|
|
clipRule="evenodd"
|
|
/>
|
|
</svg>
|
|
Categories
|
|
{categoryFilter !== "all" && (
|
|
<span className={styles.activeCatBadge}>
|
|
{categoryEntries.find((c) => c.key === categoryFilter)?.label}
|
|
</span>
|
|
)}
|
|
</button>
|
|
|
|
<aside className={`${styles.sidebar} ${sidebarOpen ? styles.sidebarOpen : ""}`}>
|
|
<div className={styles.sidebarHeader}>
|
|
<h2 className={styles.sidebarTitle}>Categories</h2>
|
|
{categoryFilter !== "all" && (
|
|
<button className={styles.sidebarClear} onClick={() => setCategoryFilter("all")}>
|
|
Clear
|
|
</button>
|
|
)}
|
|
</div>
|
|
<nav className={styles.catList}>
|
|
<button
|
|
className={`${styles.catItem} ${categoryFilter === "all" ? styles.catItemActive : ""}`}
|
|
onClick={() => {
|
|
setCategoryFilter("all");
|
|
setSidebarOpen(false);
|
|
}}
|
|
>
|
|
<span className={styles.catItemIcon}>{"\u{1F4CB}"}</span>
|
|
<span className={styles.catItemLabel}>All Skills</span>
|
|
<span className={styles.catItemCount}>{filtered.length}</span>
|
|
</button>
|
|
{categoryEntries.map((cat) => (
|
|
<button
|
|
key={cat.key}
|
|
className={`${styles.catItem} ${categoryFilter === cat.key ? styles.catItemActive : ""}`}
|
|
onClick={() => handleCategoryClick(cat.key)}
|
|
>
|
|
<span className={styles.catItemIcon}>
|
|
{CATEGORY_ICONS[cat.key] || "\u{1F4E6}"}
|
|
</span>
|
|
<span className={styles.catItemLabel}>{cat.label}</span>
|
|
<span className={styles.catItemCount}>{cat.count}</span>
|
|
</button>
|
|
))}
|
|
</nav>
|
|
</aside>
|
|
|
|
<main className={styles.main} ref={gridRef}>
|
|
{(search || sourceFilter !== "all" || categoryFilter !== "all") && (
|
|
<div className={styles.filterSummary}>
|
|
<span className={styles.filterCount}>
|
|
{filtered.length} result{filtered.length !== 1 ? "s" : ""}
|
|
</span>
|
|
{search && (
|
|
<span className={styles.filterChip}>
|
|
“{search}”
|
|
<button onClick={() => setSearch("")}>×</button>
|
|
</span>
|
|
)}
|
|
{sourceFilter !== "all" && (
|
|
<span className={styles.filterChip}>
|
|
{SOURCE_CONFIG[sourceFilter]?.label || sourceFilter}
|
|
<button onClick={() => setSourceFilter("all")}>×</button>
|
|
</span>
|
|
)}
|
|
{categoryFilter !== "all" && (
|
|
<span className={styles.filterChip}>
|
|
{categoryEntries.find((c) => c.key === categoryFilter)?.label ||
|
|
categoryFilter}
|
|
<button onClick={() => setCategoryFilter("all")}>×</button>
|
|
</span>
|
|
)}
|
|
<button className={styles.clearAllBtn} onClick={clearAll}>
|
|
Clear all
|
|
</button>
|
|
</div>
|
|
)}
|
|
|
|
{visible.length > 0 ? (
|
|
<>
|
|
<div className={styles.grid}>
|
|
{visible.map((skill, i) => {
|
|
const key = `${skill.source}-${skill.name}-${i}`;
|
|
return (
|
|
<SkillCard
|
|
key={key}
|
|
skill={skill}
|
|
query={search}
|
|
expanded={expandedCard === key}
|
|
onToggle={() =>
|
|
setExpandedCard(expandedCard === key ? null : key)
|
|
}
|
|
onCategoryClick={handleCategoryClick}
|
|
onTagClick={handleTagClick}
|
|
style={{ animationDelay: `${Math.min(i, 20) * 25}ms` }}
|
|
/>
|
|
);
|
|
})}
|
|
</div>
|
|
{hasMore && (
|
|
<div className={styles.loadMoreWrap}>
|
|
<button
|
|
className={styles.loadMoreBtn}
|
|
onClick={() => setVisibleCount((v) => v + PAGE_SIZE)}
|
|
>
|
|
Show more ({filtered.length - visibleCount} remaining)
|
|
</button>
|
|
</div>
|
|
)}
|
|
</>
|
|
) : (
|
|
<div className={styles.empty}>
|
|
<div className={styles.emptyIcon}>{"\u{1F50D}"}</div>
|
|
<h3 className={styles.emptyTitle}>No skills found</h3>
|
|
<p className={styles.emptyDesc}>
|
|
Try a different search term or clear your filters.
|
|
</p>
|
|
<button className={styles.emptyReset} onClick={clearAll}>
|
|
Reset all filters
|
|
</button>
|
|
</div>
|
|
)}
|
|
</main>
|
|
</div>
|
|
</div>
|
|
|
|
{sidebarOpen && (
|
|
<div className={styles.backdrop} onClick={() => setSidebarOpen(false)} />
|
|
)}
|
|
</Layout>
|
|
);
|
|
}
|