mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-19 02:17:09 +00:00
feat(website): redesign homepage as string board and add feature map
The homepage now shows the product's core idea directly: one source folder strung to many AI tools. Visitors can pin and unpin tools and watch the sync output follow, instead of reading a feature list. A new /features page groups all 33 commands by the job they serve with a live filter, addressing the difficulty of finding the right command among 100+ docs pages. Command data lives in src/data/featureMap.ts so the homepage teaser and the map stay in sync.
This commit is contained in:
@@ -175,6 +175,11 @@ const config: Config = {
|
||||
label: 'Reference',
|
||||
position: 'left',
|
||||
},
|
||||
{
|
||||
to: '/features',
|
||||
label: 'Feature map',
|
||||
position: 'left',
|
||||
},
|
||||
{
|
||||
to: '/blog',
|
||||
label: 'Blog',
|
||||
|
||||
@@ -5,7 +5,7 @@
|
||||
* Typography: Inter (headings) + IBM Plex Sans (body) + JetBrains Mono (code)
|
||||
*/
|
||||
|
||||
@import url('https://fonts.googleapis.com/css2?family=Kalam:wght@700&family=Inter:wght@400;500;600;700&family=IBM+Plex+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&display=swap');
|
||||
@import url('https://fonts.googleapis.com/css2?family=Kalam:wght@400;700&family=Inter:wght@400;500;600;700&family=IBM+Plex+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&display=swap');
|
||||
|
||||
/* ========================================
|
||||
LIGHT MODE — Paper
|
||||
|
||||
@@ -0,0 +1,145 @@
|
||||
// Feature Map data: every command grouped by the job it serves.
|
||||
// Shared by the homepage teaser and the /features page.
|
||||
|
||||
export type FeatureItem = {
|
||||
cmd: string;
|
||||
what: string;
|
||||
kw: string;
|
||||
href: string;
|
||||
};
|
||||
|
||||
export type FeatureGroup = {
|
||||
id: string;
|
||||
num: string;
|
||||
title: string;
|
||||
when: string;
|
||||
teaser: string;
|
||||
items: FeatureItem[];
|
||||
guides: {label: string; href: string}[];
|
||||
};
|
||||
|
||||
const C = '/docs/reference/commands/';
|
||||
const D = '/docs/';
|
||||
|
||||
export const COMMAND_COUNT = 33;
|
||||
export const TARGET_COUNT = 66;
|
||||
|
||||
export const FEATURE_GROUPS: FeatureGroup[] = [
|
||||
{
|
||||
id: 'setup',
|
||||
num: '01',
|
||||
title: 'Get set up',
|
||||
when: 'first time, a new machine, or a new AI tool',
|
||||
teaser: 'init · install · sync',
|
||||
items: [
|
||||
{cmd: 'init', what: 'Detect installed tools and create the source folder', kw: 'start begin setup detect config', href: C + 'init'},
|
||||
{cmd: 'install', what: 'Add skills from GitHub, any git URL or a local path', kw: 'add get download repo clone', href: C + 'install'},
|
||||
{cmd: 'sync', what: 'Symlink the source into every target', kw: 'link symlink apply', href: C + 'sync'},
|
||||
{cmd: 'doctor', what: 'Check config, targets and symlink health', kw: 'diagnose broken health fix', href: C + 'doctor'},
|
||||
{cmd: 'completion', what: 'Shell completions for zsh, bash and fish', kw: 'shell tab autocomplete', href: C + 'completion'},
|
||||
{cmd: 'upgrade', what: 'Upgrade the skillshare binary itself', kw: 'version latest self update', href: C + 'upgrade'},
|
||||
],
|
||||
guides: [
|
||||
{label: 'First sync in 5 minutes', href: D + 'getting-started/first-sync'},
|
||||
{label: 'From existing skills', href: D + 'getting-started/from-existing-skills'},
|
||||
{label: 'Windows notes', href: D + 'troubleshooting/windows'},
|
||||
],
|
||||
},
|
||||
{
|
||||
id: 'sync',
|
||||
num: '02',
|
||||
title: 'Keep tools in sync',
|
||||
when: 'daily: you changed a skill, added a tool, something drifted',
|
||||
teaser: 'status · diff · collect',
|
||||
items: [
|
||||
{cmd: 'status', what: 'What is linked, local or out of date, per target', kw: 'state overview drift', href: C + 'status'},
|
||||
{cmd: 'diff', what: 'Differences between source and targets', kw: 'compare changed', href: C + 'diff'},
|
||||
{cmd: 'collect', what: 'Pull skills created inside a tool back to the source', kw: 'reverse import bidirectional cursor claude', href: C + 'collect'},
|
||||
{cmd: 'check', what: 'Which tracked repos have updates upstream', kw: 'outdated remote', href: C + 'check'},
|
||||
{cmd: 'update', what: 'Update tracked repos and installed skills', kw: 'refresh pull latest', href: C + 'update'},
|
||||
{cmd: 'uninstall', what: 'Remove a skill from source and all targets', kw: 'delete remove', href: C + 'uninstall'},
|
||||
],
|
||||
guides: [
|
||||
{label: 'Daily workflow', href: D + 'how-to/daily-tasks/daily-workflow'},
|
||||
{label: 'Sync modes: merge vs symlink', href: D + 'understand/sync-modes'},
|
||||
{label: 'Source and targets', href: D + 'understand/source-and-targets'},
|
||||
],
|
||||
},
|
||||
{
|
||||
id: 'find',
|
||||
num: '03',
|
||||
title: 'Find & install skills',
|
||||
when: 'looking for something someone already wrote',
|
||||
teaser: 'search · hub · list',
|
||||
items: [
|
||||
{cmd: 'search', what: 'Search GitHub for skills and install from the results', kw: 'discover github lookup', href: C + 'search'},
|
||||
{cmd: 'hub', what: 'Saved hub sources for organization-wide discovery', kw: 'index catalog registry org', href: C + 'hub'},
|
||||
{cmd: 'list', what: 'What you have installed, with filters', kw: 'show installed ls', href: C + 'list'},
|
||||
{cmd: 'tui', what: 'Toggle the interactive terminal UI globally', kw: 'interactive terminal browse', href: C + 'tui'},
|
||||
{cmd: 'ui', what: 'Web dashboard on localhost:19420', kw: 'browser web dashboard gui', href: C + 'ui'},
|
||||
],
|
||||
guides: [
|
||||
{label: 'Skill discovery', href: D + 'how-to/daily-tasks/skill-discovery'},
|
||||
{label: 'Hub index', href: D + 'how-to/sharing/hub-index'},
|
||||
{label: 'URL formats', href: D + 'reference/appendix/url-formats'},
|
||||
],
|
||||
},
|
||||
{
|
||||
id: 'share',
|
||||
num: '04',
|
||||
title: 'Share & teams',
|
||||
when: 'same skills across machines, a team, or one project',
|
||||
teaser: 'push · pull · --track',
|
||||
items: [
|
||||
{cmd: 'push / pull', what: 'Git-sync the source folder with any remote', kw: 'git remote machine laptop desktop github gitlab', href: C + 'push'},
|
||||
{cmd: 'commit', what: 'Commit source changes locally without pushing', kw: 'git save', href: C + 'commit'},
|
||||
{cmd: 'install --track', what: 'Follow an organization repo; updates flow in with update', kw: 'team org standards tracked company', href: D + 'understand/tracked-repositories'},
|
||||
{cmd: '-p / project', what: 'Skills that ship with a repo, in .skillshare/', kw: 'project mode local repo team', href: D + 'understand/project-skills'},
|
||||
{cmd: 'target', what: 'Add, remove or configure sync targets', kw: 'custom tool path add', href: C + 'target'},
|
||||
],
|
||||
guides: [
|
||||
{label: 'Organization-wide skills', href: D + 'how-to/sharing/organization-sharing'},
|
||||
{label: 'Cross-machine sync', href: D + 'how-to/sharing/cross-machine-sync'},
|
||||
{label: 'Team onboarding recipe', href: D + 'how-to/recipes/team-onboarding-recipe'},
|
||||
],
|
||||
},
|
||||
{
|
||||
id: 'safe',
|
||||
num: '05',
|
||||
title: 'Stay safe',
|
||||
when: 'before you trust a skill, or after something went wrong',
|
||||
teaser: 'audit · backup · trash',
|
||||
items: [
|
||||
{cmd: 'audit', what: 'Scan for prompt injection, exfiltration and destructive commands', kw: 'security scan threat malicious', href: C + 'audit'},
|
||||
{cmd: 'audit-rules', what: 'Tune thresholds and the rules that block installs', kw: 'security configure severity', href: C + 'audit-rules'},
|
||||
{cmd: 'backup / restore', what: 'Snapshot targets and roll back', kw: 'undo snapshot recover', href: C + 'backup'},
|
||||
{cmd: 'trash', what: 'Soft-deleted skills with TTL expiry', kw: 'recover deleted restore', href: C + 'trash'},
|
||||
{cmd: 'log', what: 'Operation and audit history', kw: 'history what happened oplog', href: C + 'log'},
|
||||
],
|
||||
guides: [
|
||||
{label: 'Security guide', href: D + 'how-to/advanced/security'},
|
||||
{label: 'Audit engine', href: D + 'understand/audit-engine'},
|
||||
{label: 'Backup and restore', href: D + 'how-to/daily-tasks/backup-restore'},
|
||||
],
|
||||
},
|
||||
{
|
||||
id: 'write',
|
||||
num: '06',
|
||||
title: 'Write & organize',
|
||||
when: 'authoring your own, or keeping a big set tidy',
|
||||
teaser: 'new · analyze · extras',
|
||||
items: [
|
||||
{cmd: 'new', what: 'Scaffold a skill with a valid SKILL.md', kw: 'create author scaffold template', href: C + 'new'},
|
||||
{cmd: 'analyze', what: 'Context window usage and skill quality per target', kw: 'tokens size budget quality', href: C + 'analyze'},
|
||||
{cmd: 'enable / disable', what: 'Turn skills off without removing them', kw: 'toggle off pause', href: C + 'enable'},
|
||||
{cmd: 'extras', what: 'Sync rules, commands and prompts alongside skills', kw: 'rules prompts agents non-skill', href: C + 'extras'},
|
||||
{cmd: 'mcp', what: 'Portable MCP definitions synced into native agent settings', kw: 'mcp server config share', href: C + 'mcp'},
|
||||
{cmd: '.skillignore', what: 'Include, exclude and filter what gets synced', kw: 'filter ignore exclude include', href: D + 'reference/filtering'},
|
||||
],
|
||||
guides: [
|
||||
{label: 'Creating skills', href: D + 'how-to/daily-tasks/creating-skills'},
|
||||
{label: 'Organizing skills', href: D + 'how-to/daily-tasks/organizing-skills'},
|
||||
{label: 'Skill format', href: D + 'understand/skill-format'},
|
||||
],
|
||||
},
|
||||
];
|
||||
@@ -0,0 +1,366 @@
|
||||
/* Feature map: every command grouped by job, with a live filter. */
|
||||
|
||||
.page {
|
||||
padding-bottom: 3.5rem;
|
||||
}
|
||||
|
||||
.header {
|
||||
padding-top: 3rem;
|
||||
padding-bottom: 1.5rem;
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
gap: 1.5rem;
|
||||
}
|
||||
|
||||
.headRow {
|
||||
display: flex;
|
||||
align-items: flex-end;
|
||||
justify-content: space-between;
|
||||
gap: 2rem;
|
||||
}
|
||||
|
||||
.headText {
|
||||
max-width: 760px;
|
||||
}
|
||||
|
||||
.title {
|
||||
font-size: clamp(2.2rem, 4.5vw, 3.4rem);
|
||||
line-height: 1.08;
|
||||
letter-spacing: -0.015em;
|
||||
margin: 0 0 0.75rem;
|
||||
}
|
||||
|
||||
.mark {
|
||||
background: linear-gradient(transparent 58%, var(--color-postit-dark) 58%, var(--color-postit-dark) 94%, transparent 94%);
|
||||
padding: 0 6px;
|
||||
}
|
||||
|
||||
.lead {
|
||||
font-size: 1.05rem;
|
||||
line-height: 1.55;
|
||||
color: var(--color-pencil-light);
|
||||
margin: 0;
|
||||
}
|
||||
|
||||
.hint {
|
||||
font-family: 'Kalam', cursive;
|
||||
font-size: 1.5rem;
|
||||
color: var(--color-pencil-light);
|
||||
max-width: 220px;
|
||||
line-height: 1.1;
|
||||
text-align: right;
|
||||
flex-shrink: 0;
|
||||
}
|
||||
|
||||
.searchWrap {
|
||||
position: relative;
|
||||
}
|
||||
|
||||
.searchIcon {
|
||||
position: absolute;
|
||||
left: 20px;
|
||||
top: 50%;
|
||||
margin-top: -12px;
|
||||
color: var(--color-pencil);
|
||||
pointer-events: none;
|
||||
}
|
||||
|
||||
.search {
|
||||
width: 100%;
|
||||
box-sizing: border-box;
|
||||
height: 64px;
|
||||
padding: 0 20px 0 56px;
|
||||
background: var(--card-bg);
|
||||
border: 2px solid var(--card-border);
|
||||
box-shadow: 5px 5px 0 0 var(--card-border);
|
||||
font-family: var(--ifm-font-family-base);
|
||||
font-size: 1.1rem;
|
||||
font-weight: 500;
|
||||
color: var(--color-pencil);
|
||||
outline: none;
|
||||
}
|
||||
|
||||
.search:focus {
|
||||
border-color: var(--color-blue);
|
||||
box-shadow: 5px 5px 0 0 var(--color-blue);
|
||||
}
|
||||
|
||||
.search::placeholder {
|
||||
color: var(--color-muted-dark);
|
||||
}
|
||||
|
||||
:global([data-theme='dark']) .search {
|
||||
box-shadow: var(--shadow-md);
|
||||
}
|
||||
|
||||
.sr {
|
||||
position: absolute;
|
||||
width: 1px;
|
||||
height: 1px;
|
||||
overflow: hidden;
|
||||
clip: rect(0 0 0 0);
|
||||
white-space: nowrap;
|
||||
}
|
||||
|
||||
.chipRow {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: space-between;
|
||||
gap: 1rem;
|
||||
flex-wrap: wrap;
|
||||
}
|
||||
|
||||
.chips {
|
||||
display: flex;
|
||||
flex-wrap: wrap;
|
||||
gap: 0.5rem;
|
||||
}
|
||||
|
||||
.chip {
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
height: 40px;
|
||||
padding: 0 1rem;
|
||||
border: 1.5px solid var(--card-border);
|
||||
border-radius: var(--radius-wobbly-sm);
|
||||
background: var(--card-bg);
|
||||
font-family: var(--ifm-font-family-base);
|
||||
font-size: 0.875rem;
|
||||
font-weight: 500;
|
||||
color: var(--color-pencil);
|
||||
cursor: pointer;
|
||||
}
|
||||
|
||||
.chip:hover {
|
||||
background: var(--color-postit);
|
||||
}
|
||||
|
||||
.chipOn,
|
||||
.chipOn:hover {
|
||||
background: var(--color-pencil);
|
||||
color: var(--color-paper);
|
||||
}
|
||||
|
||||
.count {
|
||||
font-family: var(--ifm-font-family-monospace);
|
||||
font-size: 0.8rem;
|
||||
color: var(--color-pencil-light);
|
||||
white-space: nowrap;
|
||||
}
|
||||
|
||||
/* Groups */
|
||||
.grid {
|
||||
display: grid;
|
||||
grid-template-columns: repeat(2, minmax(0, 1fr));
|
||||
gap: 2rem;
|
||||
align-items: start;
|
||||
padding-top: 0.5rem;
|
||||
padding-bottom: 2.5rem;
|
||||
}
|
||||
|
||||
.group {
|
||||
padding: 1.6rem 1.9rem 1.5rem;
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
gap: 0.75rem;
|
||||
background: var(--card-bg);
|
||||
border: 2px solid var(--card-border);
|
||||
border-radius: var(--radius-wobbly);
|
||||
box-shadow: 6px 6px 0 0 var(--card-border);
|
||||
}
|
||||
|
||||
:global([data-theme='dark']) .group {
|
||||
box-shadow: var(--shadow-lg);
|
||||
}
|
||||
|
||||
.groupHead {
|
||||
display: flex;
|
||||
align-items: baseline;
|
||||
gap: 0.875rem;
|
||||
}
|
||||
|
||||
.num {
|
||||
font-family: var(--ifm-heading-font-family);
|
||||
font-size: 1.9rem;
|
||||
font-weight: 700;
|
||||
color: var(--color-blue);
|
||||
}
|
||||
|
||||
.groupTitle {
|
||||
font-size: 1.75rem;
|
||||
margin: 0;
|
||||
}
|
||||
|
||||
.when {
|
||||
font-family: 'Kalam', cursive;
|
||||
font-size: 1.3rem;
|
||||
color: var(--color-pencil-light);
|
||||
margin: -0.4rem 0 0;
|
||||
}
|
||||
|
||||
.rows {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
border-top: 1.5px dashed var(--color-muted-dark);
|
||||
padding-top: 0.5rem;
|
||||
}
|
||||
|
||||
.row {
|
||||
display: grid;
|
||||
grid-template-columns: 172px minmax(0, 1fr) 20px;
|
||||
align-items: center;
|
||||
gap: 0.875rem;
|
||||
padding: 0.55rem 0.75rem;
|
||||
margin: 0 -0.75rem;
|
||||
text-decoration: none;
|
||||
color: var(--color-pencil);
|
||||
border-radius: var(--radius-wobbly-sm);
|
||||
}
|
||||
|
||||
.row:hover {
|
||||
background: var(--color-paper-warm);
|
||||
color: var(--color-pencil);
|
||||
text-decoration: none;
|
||||
}
|
||||
|
||||
.cmd {
|
||||
display: inline-block;
|
||||
padding: 3px 9px;
|
||||
background: var(--color-postit);
|
||||
border: 1.5px solid var(--card-border);
|
||||
border-radius: 0;
|
||||
font-size: 0.8rem;
|
||||
font-weight: 600;
|
||||
color: var(--color-pencil);
|
||||
white-space: nowrap;
|
||||
}
|
||||
|
||||
.what {
|
||||
font-size: 0.95rem;
|
||||
line-height: 1.4;
|
||||
}
|
||||
|
||||
.arrow {
|
||||
opacity: 0.35;
|
||||
transition: opacity 0.12s, transform 0.12s;
|
||||
}
|
||||
|
||||
.row:hover .arrow {
|
||||
opacity: 1;
|
||||
transform: translateX(2px);
|
||||
}
|
||||
|
||||
.guides {
|
||||
display: flex;
|
||||
flex-wrap: wrap;
|
||||
align-items: center;
|
||||
gap: 0.375rem 0.875rem;
|
||||
padding-top: 0.6rem;
|
||||
border-top: 1.5px dashed var(--color-muted-dark);
|
||||
}
|
||||
|
||||
.guidesLabel {
|
||||
font-family: var(--ifm-font-family-monospace);
|
||||
font-size: 0.7rem;
|
||||
letter-spacing: 0.08em;
|
||||
text-transform: uppercase;
|
||||
color: var(--color-pencil-light);
|
||||
}
|
||||
|
||||
.guide {
|
||||
font-size: 0.85rem;
|
||||
}
|
||||
|
||||
.empty {
|
||||
grid-column: 1 / -1;
|
||||
padding: 2.5rem;
|
||||
border: 2px dashed var(--color-muted-dark);
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
align-items: center;
|
||||
gap: 0.75rem;
|
||||
text-align: center;
|
||||
}
|
||||
|
||||
.emptyTitle {
|
||||
font-family: var(--ifm-heading-font-family);
|
||||
font-size: 1.75rem;
|
||||
font-weight: 700;
|
||||
margin: 0;
|
||||
}
|
||||
|
||||
/* Fallback band */
|
||||
.fallback {
|
||||
padding: 2rem 2.25rem;
|
||||
background: var(--color-postit);
|
||||
border: 2px solid var(--card-border);
|
||||
box-shadow: 6px 6px 0 0 var(--card-border);
|
||||
display: grid;
|
||||
grid-template-columns: minmax(0, 1fr) auto;
|
||||
gap: 1.5rem;
|
||||
align-items: center;
|
||||
transform: rotate(-0.2deg);
|
||||
}
|
||||
|
||||
:global([data-theme='dark']) .fallback {
|
||||
box-shadow: var(--shadow-lg);
|
||||
}
|
||||
|
||||
.fallbackTitle {
|
||||
font-size: 1.9rem;
|
||||
margin: 0 0 0.375rem;
|
||||
}
|
||||
|
||||
.fallbackLinks {
|
||||
display: flex;
|
||||
flex-wrap: wrap;
|
||||
gap: 0.625rem;
|
||||
justify-content: flex-end;
|
||||
}
|
||||
|
||||
@media (max-width: 996px) {
|
||||
.grid {
|
||||
grid-template-columns: 1fr;
|
||||
}
|
||||
|
||||
.fallback {
|
||||
grid-template-columns: 1fr;
|
||||
}
|
||||
|
||||
.fallbackLinks {
|
||||
justify-content: flex-start;
|
||||
}
|
||||
}
|
||||
|
||||
@media (max-width: 640px) {
|
||||
.header {
|
||||
padding-top: 2rem;
|
||||
}
|
||||
|
||||
.headRow {
|
||||
flex-direction: column;
|
||||
align-items: flex-start;
|
||||
gap: 0.75rem;
|
||||
}
|
||||
|
||||
.hint {
|
||||
text-align: left;
|
||||
}
|
||||
|
||||
.search {
|
||||
height: 56px;
|
||||
font-size: 1rem;
|
||||
}
|
||||
|
||||
.group {
|
||||
padding: 1.25rem 1.1rem;
|
||||
}
|
||||
|
||||
.row {
|
||||
grid-template-columns: minmax(0, 1fr) 20px;
|
||||
}
|
||||
|
||||
.row > span:first-child {
|
||||
grid-column: 1 / -1;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,131 @@
|
||||
import type {ReactNode} from 'react';
|
||||
import {useState} from 'react';
|
||||
import Link from '@docusaurus/Link';
|
||||
import Layout from '@theme/Layout';
|
||||
import Heading from '@theme/Heading';
|
||||
import {ArrowRight, Search} from 'lucide-react';
|
||||
|
||||
import {COMMAND_COUNT, FEATURE_GROUPS} from '../data/featureMap';
|
||||
import styles from './features.module.css';
|
||||
|
||||
export default function Features(): ReactNode {
|
||||
const [q, setQ] = useState('');
|
||||
const [group, setGroup] = useState('all');
|
||||
const needle = q.trim().toLowerCase();
|
||||
|
||||
const groups = FEATURE_GROUPS.map((g) => {
|
||||
const items = needle
|
||||
? g.items.filter((it) => `${it.cmd} ${it.what} ${it.kw} ${g.title} ${g.when}`.toLowerCase().includes(needle))
|
||||
: g.items;
|
||||
const visible = (group === 'all' || group === g.id) && items.length > 0;
|
||||
return {...g, items, visible};
|
||||
});
|
||||
const count = groups.reduce((n, g) => n + (g.visible ? g.items.length : 0), 0);
|
||||
const chips = [{id: 'all', title: 'All'}, ...FEATURE_GROUPS];
|
||||
|
||||
return (
|
||||
<Layout title="Feature map" description="Every skillshare command, grouped by the job you're trying to do.">
|
||||
<div className={styles.page}>
|
||||
<header className={`container ${styles.header}`}>
|
||||
<div className={styles.headRow}>
|
||||
<div className={styles.headText}>
|
||||
<Heading as="h1" className={styles.title}>
|
||||
Find the feature <span className={styles.mark}>you actually need.</span>
|
||||
</Heading>
|
||||
<p className={styles.lead}>
|
||||
{COMMAND_COUNT} commands and 100+ docs pages, grouped by the job you're trying to do. Type a task, a command,
|
||||
or a word you remember from the error.
|
||||
</p>
|
||||
</div>
|
||||
<span className={styles.hint}>start from the job,<br />not the command list</span>
|
||||
</div>
|
||||
|
||||
<div className={styles.searchWrap}>
|
||||
<label htmlFor="feature-q" className={styles.sr}>Filter commands by task, name or keyword</label>
|
||||
<Search className={styles.searchIcon} size={24} aria-hidden="true" />
|
||||
<input
|
||||
id="feature-q"
|
||||
className={styles.search}
|
||||
type="search"
|
||||
value={q}
|
||||
onChange={(e) => setQ(e.target.value)}
|
||||
placeholder="Try “share with my team”, “audit”, “windows”, “symlink”…"
|
||||
autoComplete="off"
|
||||
/>
|
||||
</div>
|
||||
|
||||
<div className={styles.chipRow}>
|
||||
<div className={styles.chips}>
|
||||
{chips.map((c) => (
|
||||
<button
|
||||
key={c.id}
|
||||
type="button"
|
||||
className={`${styles.chip} ${group === c.id ? styles.chipOn : ''}`}
|
||||
onClick={() => setGroup(c.id)}
|
||||
aria-pressed={group === c.id}
|
||||
>
|
||||
{c.title}
|
||||
</button>
|
||||
))}
|
||||
</div>
|
||||
<span className={styles.count}>
|
||||
{count} of {COMMAND_COUNT} commands
|
||||
</span>
|
||||
</div>
|
||||
</header>
|
||||
|
||||
<main className={`container ${styles.grid}`}>
|
||||
{groups.filter((g) => g.visible).map((g) => (
|
||||
<section key={g.id} className={styles.group}>
|
||||
<div className={styles.groupHead}>
|
||||
<span className={styles.num}>{g.num}</span>
|
||||
<Heading as="h2" className={styles.groupTitle}>{g.title}</Heading>
|
||||
</div>
|
||||
<p className={styles.when}>{g.when}</p>
|
||||
<div className={styles.rows}>
|
||||
{g.items.map((it) => (
|
||||
<Link key={it.cmd} to={it.href} className={styles.row}>
|
||||
<span><code className={styles.cmd}>{it.cmd}</code></span>
|
||||
<span className={styles.what}>{it.what}</span>
|
||||
<ArrowRight className={styles.arrow} size={18} aria-hidden="true" />
|
||||
</Link>
|
||||
))}
|
||||
</div>
|
||||
<div className={styles.guides}>
|
||||
<span className={styles.guidesLabel}>Guides</span>
|
||||
{g.guides.map((d) => (
|
||||
<Link key={d.href} to={d.href} className={styles.guide}>{d.label}</Link>
|
||||
))}
|
||||
</div>
|
||||
</section>
|
||||
))}
|
||||
|
||||
{count === 0 && (
|
||||
<div className={styles.empty}>
|
||||
<p className={styles.emptyTitle}>Nothing matches “{q}”.</p>
|
||||
<p className={styles.lead}>Try a shorter word, or browse the full reference below.</p>
|
||||
<button type="button" className="button button--secondary" onClick={() => { setQ(''); setGroup('all'); }}>
|
||||
Clear filter
|
||||
</button>
|
||||
</div>
|
||||
)}
|
||||
</main>
|
||||
|
||||
<section className="container">
|
||||
<div className={styles.fallback}>
|
||||
<div>
|
||||
<Heading as="h2" className={styles.fallbackTitle}>Still can't find it?</Heading>
|
||||
<p className={styles.lead}>Everything is indexed in the reference, and the FAQ covers the questions people actually ask.</p>
|
||||
</div>
|
||||
<div className={styles.fallbackLinks}>
|
||||
<Link className="button button--primary" to="/docs/reference/commands">Full command reference</Link>
|
||||
<Link className="button button--secondary" to="/docs/troubleshooting/faq">FAQ</Link>
|
||||
<Link className="button button--secondary" to="/docs/troubleshooting">Troubleshooting</Link>
|
||||
<Link className="button button--secondary" href="https://github.com/runkids/skillshare/issues">Ask on GitHub</Link>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
</div>
|
||||
</Layout>
|
||||
);
|
||||
}
|
||||
+861
-781
File diff suppressed because it is too large
Load Diff
+390
-321
@@ -1,13 +1,214 @@
|
||||
import type {ReactNode} from 'react';
|
||||
import {useState} from 'react';
|
||||
import type {ReactNode, RefObject} from 'react';
|
||||
import {useEffect, useRef, useState} from 'react';
|
||||
import Link from '@docusaurus/Link';
|
||||
import useDocusaurusContext from '@docusaurus/useDocusaurusContext';
|
||||
import Layout from '@theme/Layout';
|
||||
import Heading from '@theme/Heading';
|
||||
import {Copy, Check, Apple, Terminal, GitBranch, FolderSync, ArrowLeftRight, Globe, ShieldCheck, LayoutDashboard, Compass, Users, PenTool} from 'lucide-react';
|
||||
import {Copy, Check, Apple, Terminal, ShieldCheck} from 'lucide-react';
|
||||
|
||||
import {COMMAND_COUNT, FEATURE_GROUPS, TARGET_COUNT} from '../data/featureMap';
|
||||
import styles from './index.module.css';
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// Board scaling: boards are laid out at a fixed design size and scaled to fit.
|
||||
// ---------------------------------------------------------------------------
|
||||
|
||||
function useBoardScale(ref: RefObject<HTMLDivElement | null>, baseWidth: number): number {
|
||||
const [scale, setScale] = useState(1);
|
||||
useEffect(() => {
|
||||
const el = ref.current;
|
||||
if (!el) return undefined;
|
||||
const ro = new ResizeObserver(([entry]) => {
|
||||
setScale(Math.min(1, entry.contentRect.width / baseWidth));
|
||||
});
|
||||
ro.observe(el);
|
||||
return () => ro.disconnect();
|
||||
}, [ref, baseWidth]);
|
||||
return scale;
|
||||
}
|
||||
|
||||
function ScaledBoard({
|
||||
width,
|
||||
height,
|
||||
className,
|
||||
children,
|
||||
}: {
|
||||
width: number;
|
||||
height: number;
|
||||
className?: string;
|
||||
children: ReactNode;
|
||||
}) {
|
||||
const ref = useRef<HTMLDivElement>(null);
|
||||
const scale = useBoardScale(ref, width);
|
||||
return (
|
||||
<div ref={ref} className={styles.scaleWrap} style={{height: height * scale}}>
|
||||
<div
|
||||
className={`${styles.board} ${className ?? ''}`}
|
||||
style={{width, height, transform: `scale(${scale})`}}
|
||||
>
|
||||
{children}
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// Hero board: source logo strung to 8 of the 66 targets.
|
||||
// ---------------------------------------------------------------------------
|
||||
|
||||
type Tool = {
|
||||
id: string;
|
||||
name: string;
|
||||
path: string;
|
||||
local: number;
|
||||
left: number;
|
||||
top: number;
|
||||
rotate: number;
|
||||
string: string;
|
||||
defaultOn: boolean;
|
||||
};
|
||||
|
||||
const TOOLS: Tool[] = [
|
||||
{id: 'claude', name: 'Claude Code', path: '~/.claude/skills', local: 3, left: 110, top: 60, rotate: -1.5, string: 'M584 200 Q384 177 185 74', defaultOn: true},
|
||||
{id: 'cursor', name: 'Cursor', path: '~/.cursor/skills', local: 1, left: 390, top: 30, rotate: 1, string: 'M584 200 Q524 162 465 44', defaultOn: true},
|
||||
{id: 'codex', name: 'Codex', path: '~/.codex/skills', local: 2, left: 760, top: 30, rotate: -0.8, string: 'M584 200 Q710 162 835 44', defaultOn: true},
|
||||
{id: 'gemini', name: 'Gemini CLI', path: '~/.gemini/skills', local: 0, left: 1010, top: 80, rotate: 1.6, string: 'M584 200 Q834 187 1085 94', defaultOn: true},
|
||||
{id: 'opencode', name: 'OpenCode', path: '~/.config/opencode/skills', local: 0, left: 90, top: 430, rotate: 1.2, string: 'M584 456 Q374 490 165 444', defaultOn: true},
|
||||
{id: 'copilot', name: 'GitHub Copilot', path: '~/.copilot/skills', local: 0, left: 380, top: 530, rotate: -1, string: 'M584 456 Q520 540 455 544', defaultOn: false},
|
||||
{id: 'windsurf', name: 'Windsurf', path: '~/.codeium/windsurf/skills', local: 1, left: 740, top: 530, rotate: 0.9, string: 'M584 456 Q700 540 815 544', defaultOn: false},
|
||||
{id: 'zed', name: 'Zed', path: '~/.agents/skills', local: 0, left: 1020, top: 440, rotate: -1.4, string: 'M584 456 Q840 495 1095 454', defaultOn: false},
|
||||
];
|
||||
|
||||
const SKILL_COUNT = 14;
|
||||
|
||||
function usePinned() {
|
||||
const [on, setOn] = useState<Record<string, boolean>>(() =>
|
||||
Object.fromEntries(TOOLS.map((t) => [t.id, t.defaultOn])),
|
||||
);
|
||||
const toggle = (id: string) => setOn((prev) => ({...prev, [id]: !prev[id]}));
|
||||
const pinned = TOOLS.filter((t) => on[t.id]);
|
||||
return {on, toggle, pinned};
|
||||
}
|
||||
|
||||
function SourceLogo() {
|
||||
return (
|
||||
<div className={styles.logoWrap}>
|
||||
<div className={styles.logoShadow} aria-hidden="true" />
|
||||
<div className={styles.logoRing} aria-hidden="true" />
|
||||
<span className={styles.sparkle} aria-hidden="true">*</span>
|
||||
<span className={styles.sparkle} aria-hidden="true">+</span>
|
||||
<span className={styles.sparkle} aria-hidden="true">*</span>
|
||||
<img className={styles.logoImg} src="/img/logo.png" alt="skillshare: the source of truth" />
|
||||
<span className={`${styles.pin} ${styles.pinBlue}`} style={{left: 102, top: -26}} />
|
||||
<span className={`${styles.pin} ${styles.pinBlue}`} style={{left: 102, bottom: -26}} />
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function StringBoard({on, toggle, pinned}: ReturnType<typeof usePinned>) {
|
||||
return (
|
||||
<ScaledBoard width={1168} height={620} className={styles.heroBoard}>
|
||||
<svg width="1168" height="620" viewBox="0 0 1168 620" className={styles.strings} aria-hidden="true">
|
||||
{TOOLS.map((t, i) => (
|
||||
<path
|
||||
key={t.id}
|
||||
className={`${styles.str} ${on[t.id] ? styles.strOn : styles.strOff}`}
|
||||
d={t.string}
|
||||
style={{animationDelay: `${0.05 + i * 0.1}s`}}
|
||||
/>
|
||||
))}
|
||||
</svg>
|
||||
|
||||
<SourceLogo />
|
||||
<span className={styles.sourceCaption}>source · ~/.config/skillshare/skills/</span>
|
||||
|
||||
{TOOLS.map((t) => (
|
||||
<button
|
||||
key={t.id}
|
||||
type="button"
|
||||
className={`${styles.tool} ${on[t.id] ? '' : styles.toolOff}`}
|
||||
style={{left: t.left, top: t.top, transform: `rotate(${t.rotate}deg)`}}
|
||||
onClick={() => toggle(t.id)}
|
||||
aria-pressed={on[t.id]}
|
||||
aria-label={`${on[t.id] ? 'Unpin' : 'Pin'} ${t.name}`}
|
||||
>
|
||||
<span className={styles.pin} />
|
||||
<span className={styles.toolName}>{t.name}</span>
|
||||
<span className={styles.toolPath}>{t.path}</span>
|
||||
</button>
|
||||
))}
|
||||
|
||||
<span className={styles.note} style={{left: 272, top: 120, width: 130, textAlign: 'center'}}>
|
||||
per-skill symlinks<br />(nothing copied)
|
||||
</span>
|
||||
<span className={styles.note} style={{left: 760, top: 330, width: 190}}>
|
||||
tools you don't use<br />just hang there, unlinked
|
||||
</span>
|
||||
<Link to="/docs/reference/targets/supported-targets" className={styles.boardLink}>
|
||||
+{TARGET_COUNT - TOOLS.length} more tools on the full board →
|
||||
</Link>
|
||||
|
||||
<div className={styles.counter}>
|
||||
<div className={styles.tape} style={{width: 70, height: 20, top: -10, left: 24, transform: 'rotate(-3deg)'}} aria-hidden="true" />
|
||||
<span className={styles.counterNum}>{pinned.length}</span>
|
||||
<span className={styles.counterLabel}>pinned</span>
|
||||
</div>
|
||||
</ScaledBoard>
|
||||
);
|
||||
}
|
||||
|
||||
// Small screens: same state, no strings.
|
||||
function PinList({on, toggle}: ReturnType<typeof usePinned>) {
|
||||
return (
|
||||
<div className={styles.pinList}>
|
||||
{TOOLS.map((t) => (
|
||||
<button
|
||||
key={t.id}
|
||||
type="button"
|
||||
className={`${styles.pinChip} ${on[t.id] ? styles.pinChipOn : ''}`}
|
||||
onClick={() => toggle(t.id)}
|
||||
aria-pressed={on[t.id]}
|
||||
>
|
||||
<span className={styles.pin} />
|
||||
{t.name}
|
||||
</button>
|
||||
))}
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function SyncTerminal({pinned}: {pinned: Tool[]}) {
|
||||
return (
|
||||
<div className={styles.termWrap}>
|
||||
<div className={styles.tape} style={{top: -14, left: 40, transform: 'rotate(-5deg)'}} aria-hidden="true" />
|
||||
<div className={styles.term}>
|
||||
<div className={styles.termBar}>
|
||||
<span style={{background: '#ff4d4d'}} />
|
||||
<span style={{background: '#fff3a0'}} />
|
||||
<span style={{background: '#7bd88f'}} />
|
||||
<span className={styles.termBarText}>this output follows the board</span>
|
||||
</div>
|
||||
<pre className={styles.termBody}>
|
||||
<span className={styles.ok}>$</span> skillshare sync{'\n\n'}
|
||||
<span className={styles.termHead}>Syncing skills</span>{'\n'}
|
||||
{pinned.map((t) => (
|
||||
<span key={t.id}>
|
||||
<span className={styles.ok}>✓</span> {t.id}: merged ({SKILL_COUNT} linked, {t.local} local, 0 updated, 0 pruned){'\n'}
|
||||
</span>
|
||||
))}
|
||||
{pinned.length === 0 && <span className={styles.dim}>no targets pinned — click a tool on the board{'\n'}</span>}
|
||||
{'\n'}
|
||||
<span className={styles.dim}>{pinned.length} targets · {SKILL_COUNT} skills</span>
|
||||
</pre>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// Install
|
||||
// ---------------------------------------------------------------------------
|
||||
|
||||
type InstallMethod = 'curl' | 'powershell' | 'homebrew';
|
||||
|
||||
const INSTALL_COMMANDS: Record<InstallMethod, {command: string; label: string; icon: ReactNode}> = {
|
||||
@@ -28,47 +229,15 @@ const INSTALL_COMMANDS: Record<InstallMethod, {command: string; label: string; i
|
||||
},
|
||||
};
|
||||
|
||||
// Slight random rotations for hand-drawn card feel
|
||||
const CARD_ROTATIONS = [
|
||||
'rotate(-0.8deg)',
|
||||
'rotate(0.5deg)',
|
||||
'rotate(-0.3deg)',
|
||||
'rotate(0.7deg)',
|
||||
'rotate(-0.5deg)',
|
||||
'rotate(0.4deg)',
|
||||
];
|
||||
|
||||
function WavyDivider({color = 'var(--color-muted-dark)'}: {color?: string}) {
|
||||
return (
|
||||
<div className={styles.wavyDivider} aria-hidden="true">
|
||||
<svg viewBox="0 0 1200 40" preserveAspectRatio="none">
|
||||
<path
|
||||
d="M0,20 Q150,0 300,20 T600,20 T900,20 T1200,20"
|
||||
fill="none"
|
||||
stroke={color}
|
||||
strokeWidth="2"
|
||||
strokeDasharray="8,6"
|
||||
/>
|
||||
</svg>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function CopyButton({text}: {text: string}) {
|
||||
const [copied, setCopied] = useState(false);
|
||||
|
||||
const handleCopy = async () => {
|
||||
await navigator.clipboard.writeText(text);
|
||||
setCopied(true);
|
||||
setTimeout(() => setCopied(false), 2000);
|
||||
};
|
||||
|
||||
return (
|
||||
<button
|
||||
className={styles.copyButton}
|
||||
onClick={handleCopy}
|
||||
aria-label="Copy to clipboard"
|
||||
>
|
||||
<button className={styles.copyButton} onClick={handleCopy} aria-label="Copy to clipboard">
|
||||
{copied ? <Check size={16} /> : <Copy size={16} />}
|
||||
</button>
|
||||
);
|
||||
@@ -77,7 +246,6 @@ function CopyButton({text}: {text: string}) {
|
||||
function InstallTabs() {
|
||||
const [method, setMethod] = useState<InstallMethod>('curl');
|
||||
const current = INSTALL_COMMANDS[method];
|
||||
|
||||
return (
|
||||
<div className={styles.installSection}>
|
||||
<div className={styles.installTabs}>
|
||||
@@ -102,293 +270,203 @@ function InstallTabs() {
|
||||
);
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// Sections
|
||||
// ---------------------------------------------------------------------------
|
||||
|
||||
function HeroSection() {
|
||||
const board = usePinned();
|
||||
return (
|
||||
<header className={styles.hero}>
|
||||
<div className="container">
|
||||
{/* Logo + title group: acts as a cohesive visual unit */}
|
||||
<div className={styles.heroGroup}>
|
||||
<div className={styles.heroLogoWrapper}>
|
||||
<div className={styles.heroLogoRing} aria-hidden="true" />
|
||||
<div className={styles.heroLogoShadow} aria-hidden="true" />
|
||||
<span className={styles.heroLogoSparkle} aria-hidden="true">*</span>
|
||||
<span className={styles.heroLogoSparkle} aria-hidden="true">+</span>
|
||||
<span className={styles.heroLogoSparkle} aria-hidden="true">*</span>
|
||||
<img
|
||||
src="/img/logo.png"
|
||||
alt="skillshare"
|
||||
className={styles.heroLogo}
|
||||
/>
|
||||
<div className={styles.heroHead}>
|
||||
<div>
|
||||
<Heading as="h1" className={styles.heroTitle}>
|
||||
One folder of skills,<br />strung to <span className={styles.mark}>every AI tool.</span>
|
||||
</Heading>
|
||||
<p className={styles.heroSubtitle}>
|
||||
skillshare keeps your skills in one place and symlinks them into Claude Code, Cursor, Codex and{' '}
|
||||
{TARGET_COUNT - 3} more. Pin the tools you use. Watch the strings.
|
||||
</p>
|
||||
</div>
|
||||
|
||||
{/* Hand-drawn connector line between logo and title */}
|
||||
<svg
|
||||
className={styles.heroConnector}
|
||||
viewBox="0 0 120 24"
|
||||
aria-hidden="true"
|
||||
>
|
||||
<path
|
||||
d="M60,2 C58,8 54,12 52,16 C50,20 56,20 60,22 C64,20 70,20 68,16 C66,12 62,8 60,2"
|
||||
fill="none"
|
||||
stroke="currentColor"
|
||||
strokeWidth="1.5"
|
||||
strokeDasharray="4,3"
|
||||
strokeLinecap="round"
|
||||
/>
|
||||
</svg>
|
||||
|
||||
<Heading as="h1" className={styles.heroTitle}>
|
||||
One source of truth for{' '}
|
||||
<span className={styles.heroTitleAccent}>AI CLI skills</span>
|
||||
</Heading>
|
||||
|
||||
{/* Hand-drawn underline beneath the title */}
|
||||
<svg
|
||||
className={styles.heroUnderline}
|
||||
viewBox="0 0 400 12"
|
||||
preserveAspectRatio="none"
|
||||
aria-hidden="true"
|
||||
>
|
||||
<path
|
||||
d="M8,8 C50,3 100,6 150,5 C200,4 250,7 300,5 C350,3 380,6 392,7"
|
||||
fill="none"
|
||||
stroke="currentColor"
|
||||
strokeWidth="2.5"
|
||||
strokeLinecap="round"
|
||||
/>
|
||||
</svg>
|
||||
<span className={`${styles.hand} ${styles.heroHint}`}>click a tool to pin<br />or unpin it ↓</span>
|
||||
</div>
|
||||
|
||||
<p className={styles.heroSubtitle}>
|
||||
Sync everywhere with one command. Claude Code, OpenCode, Cursor & 50+ more.
|
||||
</p>
|
||||
<div className={styles.onlyWide}>
|
||||
<StringBoard {...board} />
|
||||
</div>
|
||||
<div className={styles.onlyNarrow}>
|
||||
<PinList {...board} />
|
||||
</div>
|
||||
|
||||
<InstallTabs />
|
||||
|
||||
<div className={styles.heroButtons}>
|
||||
<Link className="button button--primary button--lg" to="/docs/">
|
||||
Get Started
|
||||
</Link>
|
||||
<Link
|
||||
className="button button--secondary button--lg"
|
||||
href="https://github.com/runkids/skillshare"
|
||||
>
|
||||
View on GitHub
|
||||
</Link>
|
||||
<div className={styles.heroBottom}>
|
||||
<SyncTerminal pinned={board.pinned} />
|
||||
<div className={styles.installCol}>
|
||||
<Heading as="h2" className={styles.h2}>Install once. Run one command.</Heading>
|
||||
<p className={styles.lead}>
|
||||
Single Go binary, no runtime. <code className={styles.cmd}>init</code> finds the tools on this machine and pins them for you.
|
||||
</p>
|
||||
<InstallTabs />
|
||||
<div className={styles.buttons}>
|
||||
<Link className="button button--primary button--lg" to="/docs/getting-started/first-sync">
|
||||
Get Started
|
||||
</Link>
|
||||
<Link className="button button--secondary button--lg" to="/features">
|
||||
Find a feature
|
||||
</Link>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</header>
|
||||
);
|
||||
}
|
||||
|
||||
const SCENARIOS = [
|
||||
{
|
||||
icon: <Compass size={28} />,
|
||||
title: 'New to AI Tools',
|
||||
description: '5 minutes from install to first sync',
|
||||
link: '/docs/getting-started',
|
||||
},
|
||||
{
|
||||
icon: <FolderSync size={28} />,
|
||||
title: 'Multi-Tool Sync',
|
||||
description: 'Claude + Cursor + Codex — one source of truth',
|
||||
link: '/docs/learn/with-multiple-tools',
|
||||
},
|
||||
{
|
||||
icon: <Users size={28} />,
|
||||
title: 'Team Sharing',
|
||||
description: "Standardize your team's AI workflow",
|
||||
link: '/docs/how-to/sharing/organization-sharing',
|
||||
},
|
||||
{
|
||||
icon: <PenTool size={28} />,
|
||||
title: 'Write Skills',
|
||||
description: 'Create and publish your own skill set',
|
||||
link: '/docs/understand/philosophy/skill-design',
|
||||
},
|
||||
{
|
||||
icon: <ArrowLeftRight size={28} />,
|
||||
title: 'Migrating',
|
||||
description: 'Coming from another tool or manual setup',
|
||||
link: '/docs/how-to/advanced/migration',
|
||||
},
|
||||
const MOVES = [
|
||||
{cmd: 'skillshare install', color: 'var(--color-success)', text: 'Repo or local path → audit gate → source. Critical findings block it.'},
|
||||
{cmd: 'skillshare sync', color: 'var(--color-blue)', text: 'Source → every target, as per-skill symlinks.'},
|
||||
{cmd: 'skillshare collect', color: 'var(--color-danger)', text: 'A skill born inside a tool → back to the source.'},
|
||||
{cmd: 'skillshare push · pull', color: 'var(--color-pencil)', text: 'Source ↔ any git remote, so every machine has the same folder.'},
|
||||
];
|
||||
|
||||
function ScenarioSection() {
|
||||
function Card({left, top, width, height, rotate, pinLeft, bg, children}: {
|
||||
left: number; top: number; width: number; height: number; rotate: number; pinLeft: number; bg?: string; children: ReactNode;
|
||||
}) {
|
||||
return (
|
||||
<section className={styles.scenarioSection}>
|
||||
<div className="container">
|
||||
<Heading as="h2" className={styles.sectionTitle}>
|
||||
Where would you like to start?
|
||||
</Heading>
|
||||
<div className={styles.scenarioGrid}>
|
||||
{SCENARIOS.map((scenario, idx) => (
|
||||
<Link
|
||||
key={idx}
|
||||
to={scenario.link}
|
||||
className={styles.scenarioCard}
|
||||
style={{transform: CARD_ROTATIONS[idx % CARD_ROTATIONS.length]}}
|
||||
>
|
||||
<div className={styles.scenarioIcon}>{scenario.icon}</div>
|
||||
<h3>{scenario.title}</h3>
|
||||
<p>{scenario.description}</p>
|
||||
</Link>
|
||||
))}
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
<div className={styles.card} style={{left, top, width, height, transform: `rotate(${rotate}deg)`, background: bg}}>
|
||||
<span className={`${styles.pin} ${bg ? styles.pinBlue : ''}`} style={{left: pinLeft, top: -8}} />
|
||||
{children}
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
const whyFeatures = [
|
||||
{
|
||||
Icon: FolderSync,
|
||||
title: 'Non-destructive Merge',
|
||||
description: 'Sync shared skills while preserving CLI-specific ones. Per-skill symlinks keep local skills untouched.',
|
||||
},
|
||||
{
|
||||
Icon: ArrowLeftRight,
|
||||
title: 'Bidirectional Sync',
|
||||
description: 'Created a skill in Claude? Collect it back to source and share with OpenClaw, OpenCode, and others.',
|
||||
},
|
||||
{
|
||||
Icon: Globe,
|
||||
title: 'Cross-machine Sync',
|
||||
description: 'One git push/pull syncs skills across all your machines. Works with any Git host — GitHub, GitLab, Bitbucket, or self-hosted.',
|
||||
},
|
||||
{
|
||||
Icon: ShieldCheck,
|
||||
title: 'Security Audit',
|
||||
description: 'Scan skills for prompt injection, data exfiltration, and destructive commands. Critical threats block install automatically.',
|
||||
},
|
||||
{
|
||||
Icon: GitBranch,
|
||||
title: 'Dual-Level Skills',
|
||||
description: 'Organization-wide standards via tracked repos, plus project-scoped skills shared via git. Both auto-detected.',
|
||||
},
|
||||
{
|
||||
Icon: LayoutDashboard,
|
||||
title: 'Web Dashboard',
|
||||
description: 'Visual skill browsing, sync status, and management. Run skillshare ui — single binary, no setup.',
|
||||
},
|
||||
];
|
||||
|
||||
const uiHighlights = [
|
||||
{
|
||||
title: 'One-Click Install',
|
||||
description: 'Install a selected skill directly from the web flow without switching to terminal.',
|
||||
image: '/img/web-install-demo.png',
|
||||
alt: 'Web install flow for a selected skill',
|
||||
},
|
||||
{
|
||||
title: 'Dashboard Overview',
|
||||
description: 'Quickly check total skills, targets, and current sync mode.',
|
||||
image: '/img/web-dashboard-demo.png',
|
||||
alt: 'Web dashboard overview page',
|
||||
},
|
||||
{
|
||||
title: 'Skills Explorer',
|
||||
description: 'Browse installed skills and search your local catalog instantly.',
|
||||
image: '/img/web-skills-demo.png',
|
||||
alt: 'Web skills page listing installed skills',
|
||||
},
|
||||
{
|
||||
title: 'Skill Detail',
|
||||
description: 'Open SKILL.md content with metadata and repository source in one view.',
|
||||
image: '/img/web-skill-detail-demo.png',
|
||||
alt: 'Web skill detail page showing SKILL.md content',
|
||||
},
|
||||
{
|
||||
title: 'Sync Control',
|
||||
description: 'Run sync with dry-run and force options from a single control panel.',
|
||||
image: '/img/web-sync-demo.png',
|
||||
alt: 'Web sync page with dry-run and force controls',
|
||||
},
|
||||
{
|
||||
title: 'GitHub Search',
|
||||
description: 'Search remote skills and install to your source directory in one flow.',
|
||||
image: '/img/web-search-skills-demo.png',
|
||||
alt: 'Web search page for GitHub skills',
|
||||
},
|
||||
{
|
||||
title: 'Security Audit',
|
||||
description: 'Scan all installed skills for prompt injection, credential theft, and other threats.',
|
||||
image: '/img/web-audit-demo.png',
|
||||
alt: 'Web security audit page showing scan results',
|
||||
},
|
||||
];
|
||||
|
||||
function WhySection() {
|
||||
function FourMovesSection() {
|
||||
return (
|
||||
<section className={styles.why}>
|
||||
<section className={styles.section}>
|
||||
<div className="container">
|
||||
<Heading as="h2" className={styles.sectionTitle}>
|
||||
Why skillshare?
|
||||
</Heading>
|
||||
<p className={styles.sectionSubtitle}>
|
||||
Install tools get skills onto agents. <strong>skillshare keeps them in sync.</strong>
|
||||
</p>
|
||||
<div className={styles.whyGrid}>
|
||||
{whyFeatures.map((item, idx) => (
|
||||
<div
|
||||
key={idx}
|
||||
className={styles.whyCard}
|
||||
style={{transform: CARD_ROTATIONS[idx]}}
|
||||
>
|
||||
<div className={styles.whyIconWrapper}>
|
||||
<item.Icon size={22} strokeWidth={1.5} />
|
||||
</div>
|
||||
<Heading as="h3" className={styles.whyCardTitle}>
|
||||
{item.title}
|
||||
</Heading>
|
||||
<p className={styles.whyCardDescription}>{item.description}</p>
|
||||
<div className={styles.sectionHead}>
|
||||
<Heading as="h2" className={styles.h2Big}>Four moves. One board.</Heading>
|
||||
<span className={`${styles.hand} ${styles.aside}`}>everything else is a flag</span>
|
||||
</div>
|
||||
|
||||
<div className={styles.onlyWide}>
|
||||
<ScaledBoard width={1168} height={560}>
|
||||
<svg width="1168" height="560" viewBox="0 0 1168 560" className={styles.strings} aria-hidden="true">
|
||||
<path className={`${styles.str} ${styles.strOn}`} d="M714 300 Q820 250 930 152" style={{animationDelay: '0.1s'}} />
|
||||
<path className={`${styles.str} ${styles.strOn}`} d="M714 300 Q820 300 930 300" style={{animationDelay: '0.2s'}} />
|
||||
<path className={`${styles.str} ${styles.strOn}`} d="M714 300 Q820 350 930 448" style={{animationDelay: '0.3s'}} />
|
||||
<path d="M930 330 Q810 380 714 330" className={styles.arrowCollect} strokeDasharray="7 6" />
|
||||
<path d="M728 318 L714 330 L730 340" className={styles.arrowCollect} />
|
||||
<path d="M570 220 Q560 140 560 92" className={styles.arrowGit} />
|
||||
<path d="M552 108 L560 90 L570 108" className={styles.arrowGit} />
|
||||
<path d="M604 92 Q604 140 604 220" className={styles.arrowGit} strokeDasharray="7 6" />
|
||||
<path d="M594 204 L604 222 L614 204" className={styles.arrowGit} />
|
||||
<path d="M200 300 Q250 300 296 300" className={styles.arrowInstall} />
|
||||
<path d="M392 300 Q420 300 454 300" className={styles.arrowInstall} />
|
||||
<path d="M440 288 L456 300 L440 312" className={styles.arrowInstall} />
|
||||
</svg>
|
||||
|
||||
<Card left={476} top={28} width={216} height={62} rotate={0.8} pinLeft={100}>
|
||||
<span className={styles.cardTitle}>Any git remote</span>
|
||||
<span className={styles.cardSub}>GitHub · GitLab · self-hosted</span>
|
||||
</Card>
|
||||
<span className={styles.note} style={{left: 630, top: 130}}>
|
||||
push ↑ pull ↓<br /><span className={styles.noteCmd}>skillshare push · pull</span>
|
||||
</span>
|
||||
|
||||
<Card left={40} top={268} width={160} height={64} rotate={-1.2} pinLeft={72}>
|
||||
<span className={styles.cardTitle}>owner/repo</span>
|
||||
<span className={styles.cardSub}>or a local path</span>
|
||||
</Card>
|
||||
<div className={styles.stamp}>
|
||||
<ShieldCheck size={26} strokeWidth={2} />
|
||||
<span>AUDITED</span>
|
||||
</div>
|
||||
))}
|
||||
<span className={styles.note} style={{left: 236, top: 352, width: 220}}>
|
||||
every install is scanned first.<br />critical findings block it.<br />
|
||||
<span className={styles.noteCmd}>skillshare install · audit</span>
|
||||
</span>
|
||||
|
||||
<Card left={454} top={220} width={260} height={160} rotate={-0.6} pinLeft={122} bg="var(--color-postit)">
|
||||
<span className={styles.cardKicker}>Source</span>
|
||||
<span className={styles.cardCode}>~/.config/skillshare/skills/</span>
|
||||
<span className={styles.cardText}>One folder. Yours, your team's tracked repos, and project skills, side by side.</span>
|
||||
</Card>
|
||||
|
||||
<Card left={930} top={120} width={190} height={60} rotate={1} pinLeft={86}>
|
||||
<span className={styles.cardTitle}>Claude Code</span>
|
||||
<span className={styles.cardSub}>pr-review → source</span>
|
||||
</Card>
|
||||
<Card left={930} top={270} width={190} height={60} rotate={-0.8} pinLeft={86}>
|
||||
<span className={styles.cardTitle}>Cursor</span>
|
||||
<span className={styles.cardSub}>+ 1 local skill kept</span>
|
||||
</Card>
|
||||
<Card left={930} top={418} width={190} height={60} rotate={1.3} pinLeft={86}>
|
||||
<span className={styles.cardTitle}>Codex</span>
|
||||
<span className={styles.cardSub}>… {TARGET_COUNT - 3} more</span>
|
||||
</Card>
|
||||
<span className={styles.note} style={{left: 790, top: 196, color: 'var(--color-blue)'}}>
|
||||
sync →<br /><span className={styles.noteCmd}>skillshare sync</span>
|
||||
</span>
|
||||
<span className={styles.note} style={{left: 760, top: 372, color: 'var(--color-danger)'}}>
|
||||
← collect<br /><span className={styles.noteCmd}>skillshare collect cursor</span>
|
||||
</span>
|
||||
<span className={styles.note} style={{left: 40, top: 470, width: 300}}>
|
||||
merge mode never overwrites a skill the tool already had. that's the whole trick.
|
||||
</span>
|
||||
</ScaledBoard>
|
||||
</div>
|
||||
|
||||
<ul className={`${styles.onlyNarrow} ${styles.moveList}`}>
|
||||
{MOVES.map((m) => (
|
||||
<li key={m.cmd} className={styles.moveItem}>
|
||||
<code className={styles.cmd} style={{borderColor: m.color}}>{m.cmd}</code>
|
||||
<span>{m.text}</span>
|
||||
</li>
|
||||
))}
|
||||
</ul>
|
||||
</div>
|
||||
</section>
|
||||
);
|
||||
}
|
||||
|
||||
function DemoSection() {
|
||||
return (
|
||||
<section className={styles.demo}>
|
||||
<div className="container">
|
||||
<div className={styles.demoContainer}>
|
||||
<div className={styles.tapeDecoration} aria-hidden="true" />
|
||||
<img src="/img/demo.gif" alt="skillshare demo" />
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
);
|
||||
}
|
||||
const IDX_POSITIONS = [
|
||||
{left: 40, top: 40, rotate: -2},
|
||||
{left: 250, top: 70, rotate: 1.5},
|
||||
{left: 460, top: 36, rotate: -1},
|
||||
{left: 90, top: 220, rotate: 1.2},
|
||||
{left: 300, top: 250, rotate: -1.6},
|
||||
{left: 510, top: 226, rotate: 0.8},
|
||||
];
|
||||
|
||||
function UIHighlightsSection() {
|
||||
function FeatureMapTeaser() {
|
||||
return (
|
||||
<section className={styles.uiHighlights}>
|
||||
<section className={styles.section}>
|
||||
<div className="container">
|
||||
<Heading as="h2" className={styles.sectionTitle}>
|
||||
Web UI Highlights
|
||||
</Heading>
|
||||
<p className={styles.sectionSubtitle}>
|
||||
v0.10.0 delivers a complete visual workflow across dashboard, skills, install, targets, sync, collect, backup, git sync, and search.
|
||||
</p>
|
||||
<div className={styles.uiHighlightsGrid}>
|
||||
{uiHighlights.map((item) => (
|
||||
<article key={item.title} className={styles.uiHighlightCard}>
|
||||
<img src={item.image} alt={item.alt} loading="lazy" />
|
||||
<div className={styles.uiHighlightContent}>
|
||||
<Heading as="h3" className={styles.uiHighlightTitle}>
|
||||
{item.title}
|
||||
</Heading>
|
||||
<p className={styles.uiHighlightDescription}>{item.description}</p>
|
||||
</div>
|
||||
</article>
|
||||
))}
|
||||
</div>
|
||||
<div className={styles.uiHighlightsAction}>
|
||||
<Link className="button button--primary button--lg" to="/docs/reference/commands/ui">
|
||||
Explore Web UI Docs
|
||||
<div className={styles.teaser}>
|
||||
<div className={styles.teaserText}>
|
||||
<span className={`${styles.hand} ${styles.bigNum}`}>{TARGET_COUNT}</span>
|
||||
<span className={styles.teaserTitle}>tools on the board.<br />{COMMAND_COUNT} commands to move them.</span>
|
||||
<p className={styles.lead}>
|
||||
Nobody remembers {COMMAND_COUNT} commands. The map pins them by the job you're doing, with a live filter.
|
||||
</p>
|
||||
<Link className="button button--primary button--lg" to="/features">
|
||||
Open the feature map
|
||||
</Link>
|
||||
</div>
|
||||
<Link to="/features" className={`${styles.board} ${styles.teaserBoard}`}>
|
||||
{FEATURE_GROUPS.map((g, i) => (
|
||||
<span
|
||||
key={g.id}
|
||||
className={styles.idx}
|
||||
style={{left: IDX_POSITIONS[i].left, top: IDX_POSITIONS[i].top, transform: `rotate(${IDX_POSITIONS[i].rotate}deg)`}}
|
||||
>
|
||||
<span className={styles.pin} style={{left: 66, top: -8}} />
|
||||
<span className={styles.idxTitle}>{g.title}</span>
|
||||
<span className={styles.idxCmds}>{g.teaser}</span>
|
||||
</span>
|
||||
))}
|
||||
<span className={`${styles.note} ${styles.teaserNote}`}>open the full board →</span>
|
||||
</Link>
|
||||
</div>
|
||||
</div>
|
||||
@@ -396,24 +474,24 @@ function UIHighlightsSection() {
|
||||
);
|
||||
}
|
||||
|
||||
const supportedCLIs = [
|
||||
'Claude Code',
|
||||
'OpenCode',
|
||||
'Cursor',
|
||||
'Gemini CLI',
|
||||
'Codex',
|
||||
'65+ more',
|
||||
];
|
||||
|
||||
function SupportedSection() {
|
||||
function CtaSection() {
|
||||
return (
|
||||
<section className={styles.supported}>
|
||||
<section className={styles.ctaSection}>
|
||||
<div className="container">
|
||||
<p className={styles.supportedTitle}>Works with</p>
|
||||
<div className={styles.cliLogos}>
|
||||
{supportedCLIs.map((cli, idx) => (
|
||||
<span key={idx}>{cli}</span>
|
||||
))}
|
||||
<div className={styles.cta}>
|
||||
<div className={styles.tape} style={{top: -14, left: 60, transform: 'rotate(-4deg)'}} aria-hidden="true" />
|
||||
<div>
|
||||
<Heading as="h2" className={`${styles.hand} ${styles.ctaTitle}`}>Pin it once. Never copy a skill again.</Heading>
|
||||
<p className={styles.lead}>Free, MIT licensed. Uninstall leaves every tool exactly as it was.</p>
|
||||
</div>
|
||||
<div className={styles.buttons}>
|
||||
<Link className="button button--primary button--lg" to="/docs/getting-started/first-sync">
|
||||
Read the 5-minute guide
|
||||
</Link>
|
||||
<Link className="button button--secondary button--lg" href="https://github.com/runkids/skillshare">
|
||||
Star on GitHub
|
||||
</Link>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
@@ -423,22 +501,13 @@ function SupportedSection() {
|
||||
export default function Home(): ReactNode {
|
||||
const {siteConfig} = useDocusaurusContext();
|
||||
return (
|
||||
<Layout
|
||||
title="AI CLI Skills Sync Tool"
|
||||
description={siteConfig.tagline}
|
||||
>
|
||||
<Layout title="AI CLI Skills Sync Tool" description={siteConfig.tagline}>
|
||||
<div className={styles.homePage}>
|
||||
<HeroSection />
|
||||
<ScenarioSection />
|
||||
<WavyDivider />
|
||||
<main>
|
||||
<WhySection />
|
||||
<WavyDivider />
|
||||
<DemoSection />
|
||||
<WavyDivider />
|
||||
<UIHighlightsSection />
|
||||
<WavyDivider />
|
||||
<SupportedSection />
|
||||
<FourMovesSection />
|
||||
<FeatureMapTeaser />
|
||||
<CtaSection />
|
||||
</main>
|
||||
</div>
|
||||
</Layout>
|
||||
|
||||
Reference in New Issue
Block a user