diff --git a/docs/skillkit/App.tsx b/docs/skillkit/App.tsx index bffcee41..e3781250 100644 --- a/docs/skillkit/App.tsx +++ b/docs/skillkit/App.tsx @@ -76,27 +76,18 @@ export default function App(): React.ReactElement { Sources -
+
Docs - - {NPM_ICON} - {GITHUB_ICON} @@ -109,68 +100,50 @@ export default function App(): React.ReactElement {
-
+
- diff --git a/docs/skillkit/components/Attribution.tsx b/docs/skillkit/components/Attribution.tsx index 9f287b31..790e6462 100644 --- a/docs/skillkit/components/Attribution.tsx +++ b/docs/skillkit/components/Attribution.tsx @@ -1,277 +1,98 @@ import React from 'react'; -interface SkillSource { - name: string; - repo: string; - description: string; - official?: boolean; - license?: string; - skillCount?: string; -} +const OFFICIAL_SOURCES = [ + { repo: 'anthropics/skills', name: 'Anthropic' }, + { repo: 'vercel-labs/agent-skills', name: 'Vercel' }, + { repo: 'expo/skills', name: 'Expo' }, + { repo: 'remotion-dev/skills', name: 'Remotion' }, + { repo: 'supabase/agent-skills', name: 'Supabase' }, + { repo: 'stripe/ai', name: 'Stripe' }, +]; -const SKILL_SOURCES: SkillSource[] = [ - { - name: 'Anthropic Official', - repo: 'anthropics/skills', - description: 'Official Claude Code skills from Anthropic', - official: true, - license: 'Apache 2.0', - skillCount: '21+', - }, - { - name: 'Vercel Labs', - repo: 'vercel-labs/agent-skills', - description: 'Next.js, React, and Vercel platform skills', - official: true, - license: 'MIT', - skillCount: '15+', - }, - { - name: 'Expo / React Native', - repo: 'expo/skills', - description: 'Mobile development with Expo and React Native', - official: true, - license: 'MIT', - skillCount: '12+', - }, - { - name: 'Remotion Video', - repo: 'remotion-dev/skills', - description: 'Programmatic video creation with React', - official: true, - license: 'MIT', - skillCount: '8+', - }, - { - name: 'Supabase', - repo: 'supabase/agent-skills', - description: 'Database, auth, and backend skills', - official: true, - license: 'Apache 2.0', - skillCount: '10+', - }, - { - name: 'Stripe Payments', - repo: 'stripe/ai', - description: 'Payment integration and Stripe API patterns', - official: true, - license: 'MIT', - skillCount: '8+', - }, - { - name: 'Trail of Bits Security', - repo: 'trailofbits/skills', - description: 'Security analysis, auditing, and vulnerability detection', - license: 'Apache 2.0', - skillCount: '25+', - }, - { - name: 'Superpowers TDD', - repo: 'obra/superpowers', - description: 'Test-driven development and workflow automation by Jesse Obra', - license: 'MIT', - skillCount: '14+', - }, - { - name: 'Dev Patterns', - repo: 'wshobson/agents', - description: 'Development patterns and agent configurations', - license: 'MIT', - skillCount: '48+', - }, - { - name: 'Composio Awesome', - repo: 'ComposioHQ/awesome-claude-skills', - description: 'Curated collection of Claude Code skills', - license: 'MIT', - }, - { - name: 'Travis Awesome', - repo: 'travisvn/awesome-claude-skills', - description: 'Community-curated skill collection', - license: 'MIT', - }, - { - name: 'Skills Marketplace', - repo: 'mhattingpete/claude-skills-marketplace', - description: 'Community skill marketplace', - license: 'MIT', - }, - { - name: 'Dify Frontend', - repo: 'langgenius/dify', - description: 'AI application development platform patterns', - license: 'Apache 2.0', - }, - { - name: 'Better Auth', - repo: 'better-auth/skills', - description: 'Authentication and authorization patterns', - license: 'MIT', - }, - { - name: 'Nuxt / Vue', - repo: 'onmax/nuxt-skills', - description: 'Vue.js and Nuxt framework skills', - license: 'MIT', - }, - { - name: 'ElysiaJS / Bun', - repo: 'elysiajs/skills', - description: 'Bun runtime and ElysiaJS framework', - license: 'MIT', - }, - { - name: 'NestJS', - repo: 'kadajett/agent-nestjs-skills', - description: 'NestJS backend framework patterns', - license: 'MIT', - }, - { - name: 'Three.js', - repo: 'cloudai-x/threejs-skills', - description: '3D graphics and WebGL development', - license: 'MIT', - }, - { - name: 'SwiftUI iOS', - repo: 'dimillian/skills', - description: 'iOS and SwiftUI development patterns', - license: 'MIT', - }, - { - name: 'Convex Backend', - repo: 'waynesutton/convexskills', - description: 'Convex backend development', - license: 'MIT', - }, - { - name: 'Obsidian Notes', - repo: 'kepano/obsidian-skills', - description: 'Obsidian plugin and vault management', - license: 'MIT', - }, - { - name: 'Shadcn / Radix', - repo: 'giuseppe-trisciuoglio/developer-kit', - description: 'UI component libraries and design systems', - license: 'MIT', - }, - { - name: 'OpenRouter SDK', - repo: 'openrouterteam/agent-skills', - description: 'OpenRouter API integration patterns', - license: 'MIT', - }, - { - name: 'Context7', - repo: 'intellectronica/agent-skills', - description: 'Context management and documentation tools', - license: 'MIT', - }, +const COMMUNITY_SOURCES = [ + 'trailofbits/skills', + 'obra/superpowers', + 'wshobson/agents', + 'ComposioHQ/awesome-claude-skills', + 'travisvn/awesome-claude-skills', + 'mhattingpete/claude-skills-marketplace', + 'langgenius/dify', + 'better-auth/skills', + 'onmax/nuxt-skills', + 'elysiajs/skills', + 'kadajett/agent-nestjs-skills', + 'cloudai-x/threejs-skills', + 'dimillian/skills', + 'waynesutton/convexskills', + 'kepano/obsidian-skills', + 'giuseppe-trisciuoglio/developer-kit', + 'openrouterteam/agent-skills', + 'intellectronica/agent-skills', ]; export function Attribution(): React.ReactElement { - const officialSources = SKILL_SOURCES.filter(s => s.official); - const communitySources = SKILL_SOURCES.filter(s => !s.official); - return ( -
+
-
-

Skill Sources

-

- SkillKit aggregates skills from trusted sources. We credit and link back to all original creators. - Each source retains its original license. +

+

Skill Sources

+

+ Skills aggregated from open source repositories

-
-

- - Official Partner Sources -

-
- {officialSources.map(source => ( + -
-

- - Community Contributors -

-
- {communitySources.map(source => ( + -
-

- Want to add your skills to SkillKit? -

+
diff --git a/docs/skillkit/components/Commands.tsx b/docs/skillkit/components/Commands.tsx index ce623a67..57ef17d8 100644 --- a/docs/skillkit/components/Commands.tsx +++ b/docs/skillkit/components/Commands.tsx @@ -11,8 +11,10 @@ const COMMAND_GROUPS: CommandGroup[] = [ commands: [ { cmd: '', desc: 'Launch interactive TUI' }, { cmd: 'install ', desc: 'Install from GitHub' }, - { cmd: 'recommend', desc: 'Get suggestions for your project' }, + { cmd: 'add ', desc: 'Alias for install' }, + { cmd: 'recommend', desc: 'Smart suggestions' }, { cmd: 'find ', desc: 'Search 15K+ skills' }, + { cmd: 'marketplace', desc: 'Browse skills' }, ], }, { @@ -22,33 +24,63 @@ const COMMAND_GROUPS: CommandGroup[] = [ { cmd: 'sync', desc: 'Deploy to all agents' }, { cmd: 'translate --to ', desc: 'Convert formats' }, { cmd: 'update', desc: 'Update all skills' }, + { cmd: 'remove ', desc: 'Remove a skill' }, + { cmd: 'status', desc: 'Show skill status' }, ], }, { name: 'Mesh', commands: [ - { cmd: 'mesh init', desc: 'Initialize mesh network' }, + { cmd: 'mesh init', desc: 'Initialize network' }, { cmd: 'mesh discover', desc: 'Find hosts on LAN' }, - { cmd: 'message send', desc: 'Send to another agent' }, + { cmd: 'mesh add ', desc: 'Add a host' }, + { cmd: 'mesh security init', desc: 'Setup encryption' }, + { cmd: 'mesh peer trust', desc: 'Trust a peer' }, + { cmd: 'mesh health', desc: 'Check host health' }, + ], + }, + { + name: 'Message', + commands: [ + { cmd: 'message send', desc: 'Send to agent' }, { cmd: 'message inbox', desc: 'View inbox' }, + { cmd: 'message read ', desc: 'Read message' }, + { cmd: 'message reply ', desc: 'Reply to message' }, + { cmd: 'message archive', desc: 'Archive messages' }, + { cmd: 'message sent', desc: 'View sent' }, + ], + }, + { + name: 'Memory', + commands: [ + { cmd: 'memory status', desc: 'View memory status' }, + { cmd: 'memory search ', desc: 'Search learnings' }, + { cmd: 'memory compress', desc: 'Compress observations' }, + { cmd: 'memory export', desc: 'Export as skill' }, + { cmd: 'memory reinforce', desc: 'Boost memory' }, + { cmd: 'memory --global', desc: 'Global memory' }, ], }, { name: 'Team', commands: [ { cmd: 'manifest init', desc: 'Create .skills file' }, + { cmd: 'team init', desc: 'Initialize team' }, { cmd: 'team share', desc: 'Share via Git' }, { cmd: 'publish', desc: 'Submit to marketplace' }, { cmd: 'cicd init', desc: 'CI/CD templates' }, + { cmd: 'team sync', desc: 'Sync team skills' }, ], }, { name: 'Advanced', commands: [ - { cmd: 'primer', desc: 'Generate CLAUDE.md from code' }, - { cmd: 'agent translate', desc: 'Batch convert agents' }, - { cmd: 'command generate', desc: 'Create /slash commands' }, - { cmd: 'memory export', desc: 'Save session learnings' }, + { cmd: 'primer', desc: 'Generate CLAUDE.md' }, + { cmd: 'agent translate', desc: 'Batch convert' }, + { cmd: 'command generate', desc: 'Create /commands' }, + { cmd: 'context init', desc: 'Project context' }, + { cmd: 'workflow run', desc: 'Run workflow' }, + { cmd: 'test', desc: 'Test skills' }, ], }, ]; @@ -85,19 +117,19 @@ export function Commands(): React.ReactElement { })}
-
-
+
+
{group.commands.map((c) => (
- $ - + $ + {c.cmd ? `skillkit ${c.cmd}` : 'npx skillkit@latest'} - - → - {c.desc} + + → + {c.desc}
))}
diff --git a/docs/skillkit/components/Features.tsx b/docs/skillkit/components/Features.tsx index 2da3841b..3f1c913d 100644 --- a/docs/skillkit/components/Features.tsx +++ b/docs/skillkit/components/Features.tsx @@ -146,7 +146,7 @@ export function Features(): React.ReactElement {
-
+
{FEATURES.map((feature, index) => (
- v1.7.11 + v1.8.0

diff --git a/docs/skillkit/components/SkillGenerator.tsx b/docs/skillkit/components/SkillGenerator.tsx index c44ae989..2bc521ac 100644 --- a/docs/skillkit/components/SkillGenerator.tsx +++ b/docs/skillkit/components/SkillGenerator.tsx @@ -1,651 +1,123 @@ -import React, { useState, useRef, useEffect } from 'react'; -import { Button } from './Button'; -import { Card } from './Card'; -import { generateAgentSkill } from '../services/geminiService'; +import React, { useState } from 'react'; import { searchSkills, IndexedSkill } from '../data/skills-index'; -import { AgentSkill, LoadingState } from '../types'; - -interface PriorityBadgeProps { - priority: string; -} - -type ViewMode = 'search' | 'marketplace' | 'generated' | 'content'; - -const PRIORITY_COLORS = { - must: 'bg-red-900/50 text-red-300 border-red-800', - should: 'bg-yellow-900/50 text-yellow-300 border-yellow-800', - may: 'bg-blue-900/50 text-blue-300 border-blue-800', -} as const; - -function PriorityBadge({ priority }: PriorityBadgeProps): React.ReactElement { - const colorClass = PRIORITY_COLORS[priority as keyof typeof PRIORITY_COLORS] || PRIORITY_COLORS.may; - return ( - - {priority} - - ); -} - -function generateSkillMd(skill: AgentSkill): string { - const frontmatter = `--- -name: "${skill.name}" -description: "${skill.description}" -version: "${skill.version}" -tags: [${skill.tags.map(t => `"${t}"`).join(', ')}] -${skill.filePatterns?.length ? `globs: [${skill.filePatterns.map(p => `"${p}"`).join(', ')}]` : ''} ----`; - - const principlesSection = skill.principles.map(p => - `### ${p.priority.toUpperCase()}: ${p.title}\n\n${p.description}` - ).join('\n\n'); - - const patternsSection = skill.patterns.map(p => - `### ${p.name}\n\n${p.description}\n\n\`\`\`${p.language || 'typescript'}\n${p.example}\n\`\`\`` - ).join('\n\n'); - - const antiPatternsSection = skill.antiPatterns.map(ap => { - let content = `### ${ap.name}\n\n${ap.description}`; - if (ap.badExample) { - content += `\n\n**Bad:**\n\`\`\`typescript\n${ap.badExample}\n\`\`\``; - } - if (ap.goodExample) { - content += `\n\n**Good:**\n\`\`\`typescript\n${ap.goodExample}\n\`\`\``; - } - return content; - }).join('\n\n'); - - const content = `# ${skill.title} - -${skill.description} - -## When to Apply - -${skill.applicability} - -${skill.filePatterns?.length ? `**File patterns:** ${skill.filePatterns.map(p => `\`${p}\``).join(', ')}` : ''} - -## Principles - -${principlesSection} - -## Patterns - -${patternsSection} - -## Anti-Patterns - -${antiPatternsSection} - -${skill.references?.length ? `## References\n\n${skill.references.map(r => `- ${r}`).join('\n')}` : ''} -`; - - return `${frontmatter}\n\n${content}`; -} - -function downloadContent(content: string, filename: string): void { - const blob = new Blob([content], { type: 'text/markdown' }); - const url = URL.createObjectURL(blob); - const a = document.createElement('a'); - a.href = url; - a.download = filename; - document.body.appendChild(a); - a.click(); - document.body.removeChild(a); - URL.revokeObjectURL(url); -} - -// localStorage cache for AI-generated skills -const CACHE_KEY = 'skillkit_ai_cache'; -const CACHE_VERSION = 1; -const MAX_CACHE_ENTRIES = 50; -const CACHE_TTL_MS = 7 * 24 * 60 * 60 * 1000; // 7 days - -interface CachedSkill { - skill: AgentSkill; - query: string; - timestamp: number; -} - -interface SkillCache { - version: number; - skills: Record; -} - -function normalizeQuery(query: string): string { - return query.toLowerCase().trim().replace(/\s+/g, ' '); -} - -function getSkillCache(): SkillCache { - try { - const cached = localStorage.getItem(CACHE_KEY); - if (cached) { - const parsed = JSON.parse(cached) as SkillCache; - if (parsed.version === CACHE_VERSION) { - // Prune expired entries - const now = Date.now(); - let mutated = false; - for (const [key, value] of Object.entries(parsed.skills)) { - if (!value?.timestamp || now - value.timestamp >= CACHE_TTL_MS) { - delete parsed.skills[key]; - mutated = true; - } - } - if (mutated) { - localStorage.setItem(CACHE_KEY, JSON.stringify(parsed)); - } - return parsed; - } - } - } catch { - // Ignore parse errors - } - return { version: CACHE_VERSION, skills: {} }; -} - -function getCachedSkill(query: string): AgentSkill | null { - const cache = getSkillCache(); - const key = normalizeQuery(query); - const cached = cache.skills[key]; - if (cached && Date.now() - cached.timestamp < CACHE_TTL_MS) { - return cached.skill; - } - return null; -} - -function setCachedSkill(query: string, skill: AgentSkill): void { - try { - const cache = getSkillCache(); - const key = normalizeQuery(query); - cache.skills[key] = { - skill, - query: key, - timestamp: Date.now(), - }; - // Enforce max entries limit - const entries = Object.entries(cache.skills); - if (entries.length > MAX_CACHE_ENTRIES) { - entries - .sort((a, b) => a[1].timestamp - b[1].timestamp) - .slice(0, entries.length - MAX_CACHE_ENTRIES) - .forEach(([k]) => delete cache.skills[k]); - } - localStorage.setItem(CACHE_KEY, JSON.stringify(cache)); - } catch { - // Ignore storage errors (quota exceeded, etc.) - } -} export function SkillGenerator(): React.ReactElement { - const [input, setInput] = useState(''); - const [status, setStatus] = useState(LoadingState.IDLE); - const [viewMode, setViewMode] = useState('search'); - - const [marketplaceResults, setMarketplaceResults] = useState([]); - const [selectedSkill, setSelectedSkill] = useState(null); - const [skillContent, setSkillContent] = useState(null); - const [generatedSkill, setGeneratedSkill] = useState(null); - const [isFromCache, setIsFromCache] = useState(false); - const [activeTab, setActiveTab] = useState<'principles' | 'patterns' | 'antipatterns'>('principles'); - - const [error, setError] = useState(null); - const inputRef = useRef(null); + const [query, setQuery] = useState(''); + const [results, setResults] = useState([]); + const [hasSearched, setHasSearched] = useState(false); + const [copied, setCopied] = useState(null); function handleSearch(e: React.FormEvent): void { e.preventDefault(); - if (!input.trim()) return; - - setError(null); - setSelectedSkill(null); - setSkillContent(null); - setGeneratedSkill(null); - - const results = searchSkills(input); - setMarketplaceResults(results); - setViewMode(results.length > 0 ? 'marketplace' : 'search'); - setStatus(LoadingState.SUCCESS); + if (!query.trim()) return; + const found = searchSkills(query); + setResults(found); + setHasSearched(true); } - async function handleViewSkill(skill: IndexedSkill): Promise { - setSelectedSkill(skill); - setSkillContent(null); - setViewMode('content'); - - if (skill.rawUrl) { - setStatus(LoadingState.LOADING); - try { - const response = await fetch(skill.rawUrl); - if (response.ok) { - const content = await response.text(); - setSkillContent(content); - } - } catch { - // Silently handle fetch errors - } - setStatus(LoadingState.SUCCESS); - } - } - - async function handleGenerateWithAI(): Promise { - setError(null); - - // Check cache first - const cached = getCachedSkill(input); - if (cached) { - setGeneratedSkill(cached); - setIsFromCache(true); - setViewMode('generated'); - setStatus(LoadingState.SUCCESS); - return; - } - - setStatus(LoadingState.LOADING); - setIsFromCache(false); - + async function copyInstall(skill: IndexedSkill): Promise { + const cmd = `npx skillkit@latest install ${skill.id.split('/').slice(0, 2).join('/')}`; try { - const result = await generateAgentSkill(input); - setGeneratedSkill(result); - setCachedSkill(input, result); // Cache the result - setViewMode('generated'); - setStatus(LoadingState.SUCCESS); + await navigator.clipboard.writeText(cmd); + setCopied(skill.id); + setTimeout(() => setCopied(null), 2000); } catch { - setError("Failed to generate skill. Please try again."); - setStatus(LoadingState.ERROR); + // ignore } } - function submitToMarketplace(): void { - if (!generatedSkill) return; - - const slug = generatedSkill.name.toLowerCase().replace(/\s+/g, '-').replace(/[^a-z0-9-]/g, ''); - const skillContent = generateSkillMd(generatedSkill); - - const body = `## 📤 AI-Generated Skill: ${generatedSkill.title} - -### Skill Details -- **Name:** ${generatedSkill.name} -- **Description:** ${generatedSkill.description} -- **Tags:** ${generatedSkill.tags.join(', ')} -- **Version:** ${generatedSkill.version} - -### SKILL.md Content - -
-Click to expand - -\`\`\`markdown -${skillContent.slice(0, 4000)}${skillContent.length > 4000 ? '\n...(truncated)' : ''} -\`\`\` - -
- -### Checklist for Maintainer -- [ ] Review skill content for quality -- [ ] Add to \`marketplace/skills.json\` - ---- -**Generated via:** AI Skill Generator -**Search query:** "${input}"`; - - const title = encodeURIComponent(`[AI Skill] ${generatedSkill.title}`); - const encodedBody = encodeURIComponent(body); - const url = `https://github.com/rohitg00/skillkit/issues/new?title=${title}&body=${encodedBody}&labels=ai-generated,skill-submission`; - - window.open(url, '_blank', 'noopener,noreferrer'); - } - - function handleBack(): void { - switch (viewMode) { - case 'content': - setViewMode('marketplace'); - setSelectedSkill(null); - setSkillContent(null); - break; - case 'generated': - setViewMode(marketplaceResults.length > 0 ? 'marketplace' : 'search'); - setGeneratedSkill(null); - break; - default: - setViewMode('search'); - setMarketplaceResults([]); - } - } - - function downloadSkillMd(): void { - if (skillContent) { - downloadContent(skillContent, 'SKILL.md'); - } - } - - function downloadGeneratedSkillMd(): void { - if (generatedSkill) { - downloadContent(generateSkillMd(generatedSkill), 'SKILL.md'); - } - } - - // Focus input only after user interaction, not on initial page load - useEffect(() => { - if (status === LoadingState.SUCCESS && inputRef.current) { - inputRef.current.focus({ preventScroll: true }); - } - }, [status]); - return ( -
-
-

Skill Finder

-

- Search the marketplace or generate new skills with AI. +

+
+

Find Skills

+

+ Search 15,000+ skills from the marketplace

-
-
+ +
setInput(e.target.value)} - placeholder="e.g., React hooks, TypeScript, Next.js..." - className="flex-1 bg-surface border border-zinc-700 text-white px-4 py-3 focus:ring-2 focus:ring-white focus:border-transparent outline-none font-mono text-sm placeholder-zinc-600" - disabled={status === LoadingState.LOADING} + value={query} + onChange={(e) => setQuery(e.target.value)} + placeholder="react, typescript, testing, kubernetes..." + className="flex-1 bg-zinc-900 border border-zinc-800 text-white px-4 py-3 font-mono text-sm focus:border-zinc-600 outline-none placeholder-zinc-600" /> - +
- {error &&

{error}

} - {viewMode !== 'search' && status !== LoadingState.LOADING && ( - - )} - - {viewMode === 'marketplace' && status === LoadingState.SUCCESS && ( -
-
-

- Found {marketplaceResults.length} skill{marketplaceResults.length !== 1 ? 's' : ''} in marketplace -

-
- -
- {marketplaceResults.map((skill) => ( - handleViewSkill(skill)} - > -
-
-

{skill.name}

-

{skill.description || 'No description'}

-
- {skill.source} + {hasSearched && ( +
+ {results.length > 0 ? ( +
+
+ {results.length} result{results.length !== 1 ? 's' : ''} for "{query}" +
+ {results.map((skill) => ( +
+
+
+
{skill.name}
+
{skill.description || 'No description'}
+
{skill.source}
-
- - - -
- {skill.tags.length > 0 && ( -
- {skill.tags.slice(0, 5).map((tag, idx) => ( - - {tag} - - ))} -
- )} - - ))} -
- -
-

- Don't see what you need? Generate a custom skill with AI. -

- -
-
- )} - - {viewMode === 'search' && status === LoadingState.SUCCESS && marketplaceResults.length === 0 && input && ( -
-
- No skills found for "{input}" in the marketplace. -
- -
- )} - - {viewMode === 'content' && selectedSkill && ( -
-
-
-

{selectedSkill.name}

-

{selectedSkill.description}

-
- {selectedSkill.source} - {selectedSkill.sourceUrl && ( - <> - • - - View on GitHub - - - )} -
-
- {skillContent && ( - - )} -
- - {status === LoadingState.LOADING ? ( -
Loading content...
- ) : skillContent ? ( -
-              {skillContent}
-            
- ) : ( -
-

- Skill content not available for direct preview. -

- - View on GitHub - - - - -
- )} - -
-

Install with SkillKit:

-
-              
-                npx skillkit@latest install {selectedSkill.id.split('/').slice(0, 2).join('/')}
-              
-            
-
-
- )} - - {viewMode === 'generated' && generatedSkill && ( -
-
-
-
-

{generatedSkill.title}

- - v{generatedSkill.version} - - - AI Generated - - {isFromCache && ( - - Cached - - )} -
-

{generatedSkill.description}

-
- {generatedSkill.tags.map((tag, idx) => ( - - {tag} - - ))} -
-
-
- - -
-
- - -

When to Apply

-

{generatedSkill.applicability}

- {generatedSkill.filePatterns && generatedSkill.filePatterns.length > 0 && ( -
- {generatedSkill.filePatterns.map((pattern, idx) => ( - - {pattern} - - ))} -
- )} -
- -
- {(['principles', 'patterns', 'antipatterns'] as const).map((tab) => ( - - ))} -
- -
- {activeTab === 'principles' && generatedSkill.principles.map((principle, idx) => ( - -
-

{principle.title}

- -
-

{principle.description}

-
- ))} - - {activeTab === 'patterns' && generatedSkill.patterns.map((pattern, idx) => ( - -

{pattern.name}

-

{pattern.description}

-
-                  {pattern.example}
-                
-
- ))} - - {activeTab === 'antipatterns' && generatedSkill.antiPatterns.map((ap, idx) => ( - -

{ap.name}

-

{ap.description}

- {ap.badExample && ( -
-
Bad
-
-                      {ap.badExample}
-                    
-
- )} - {ap.goodExample && ( -
-
Good
-
-                      {ap.goodExample}
-                    
-
- )} -
- ))} -
- - {generatedSkill.references && generatedSkill.references.length > 0 && ( -
-

References

- + {copied === skill.id ? 'Copied' : 'Copy'} + +
+ {skill.tags.length > 0 && ( +
+ {skill.tags.slice(0, 4).map((tag, idx) => ( + + {tag} + + ))} +
+ )} +
+ ))} +
+ ) : ( +
+ No skills found for "{query}"
)}
)} + + {!hasSearched && ( +
+
+ {['react', 'typescript', 'nextjs', 'testing', 'docker', 'kubernetes', 'python', 'security'].map(tag => ( + + ))} +
+
+ )}
); } diff --git a/docs/skillkit/components/SkillSubmitForm.tsx b/docs/skillkit/components/SkillSubmitForm.tsx index b1577082..a1c94862 100644 --- a/docs/skillkit/components/SkillSubmitForm.tsx +++ b/docs/skillkit/components/SkillSubmitForm.tsx @@ -1,549 +1,75 @@ -import React, { useState, useCallback } from 'react'; -import { Card } from './Card'; - -type Mode = 'upload' | 'import'; - -interface SkillFormData { - slug: string; - displayName: string; - description: string; - version: string; - tags: string; - repoOwner: string; - repoName: string; - skillPath: string; - authorGithub: string; - skillContent: string; -} - -const INITIAL_FORM: SkillFormData = { - slug: '', - displayName: '', - description: '', - version: '1.0.0', - tags: '', - repoOwner: '', - repoName: '', - skillPath: '', - authorGithub: '', - skillContent: '', -}; - -const TAG_SUGGESTIONS = [ - 'react', 'typescript', 'nextjs', 'python', 'rust', 'go', - 'testing', 'api', 'database', 'devops', 'security', 'mobile', -] as const; - -const GITHUB_ICON = ( - - - -); +import React, { useState } from 'react'; export function SkillSubmitForm(): React.ReactElement { - const [mode, setMode] = useState('import'); - const [form, setForm] = useState(INITIAL_FORM); - const [isDragging, setIsDragging] = useState(false); - const [fileName, setFileName] = useState(null); - const [githubUrl, setGithubUrl] = useState(''); - const [isDetecting, setIsDetecting] = useState(false); - const [detectError, setDetectError] = useState(null); + const [repoUrl, setRepoUrl] = useState(''); + const [copied, setCopied] = useState(false); - function updateField(field: keyof SkillFormData, value: string): void { - setForm(prev => { - const updated = { ...prev, [field]: value }; - if (field === 'displayName' && !prev.slug) { - updated.slug = value.toLowerCase().replace(/\s+/g, '-').replace(/[^a-z0-9-]/g, ''); - } - return updated; - }); - } + const repoMatch = repoUrl.match(/github\.com\/([^\/]+)\/([^\/\s]+)/); + const owner = repoMatch?.[1] || 'owner'; + const repo = repoMatch?.[2]?.replace(/\.git$/, '') || 'repo'; + const skillName = repo.replace(/-skill$/, '').replace(/-/g, '-'); - function addTag(tag: string): void { - const currentTags = form.tags.split(',').map(t => t.trim()).filter(Boolean); - if (!currentTags.includes(tag)) { - updateField('tags', [...currentTags, tag].join(', ')); - } - } - - function parseSkillContent(content: string): void { - const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/); - if (frontmatterMatch) { - const fm = frontmatterMatch[1]; - const nameMatch = fm.match(/name:\s*["']?([^"'\n]+)["']?/); - const descMatch = fm.match(/description:\s*["']?([^"'\n]+)["']?/); - const tagsMatch = fm.match(/tags:\s*\[([^\]]+)\]/); - const versionMatch = fm.match(/version:\s*["']?([^"'\n]+)["']?/); - - if (nameMatch) updateField('displayName', nameMatch[1].trim()); - if (descMatch) updateField('description', descMatch[1].trim()); - if (versionMatch) updateField('version', versionMatch[1].trim()); - if (tagsMatch) { - const tags = tagsMatch[1].replace(/["']/g, '').split(',').map(t => t.trim()).join(', '); - updateField('tags', tags); - } - } - updateField('skillContent', content); - } - - async function handleDetect(): Promise { - if (!githubUrl) return; - - setIsDetecting(true); - setDetectError(null); + const command = `npx skillkit@latest publish ${repoUrl || 'https://github.com/owner/repo'}`; + async function copyCommand(): Promise { + if (!repoUrl) return; try { - const urlMatch = githubUrl.match(/github\.com\/([^\/]+)\/([^\/]+)(?:\/(?:tree|blob)\/[^\/]+\/(.+))?/); - - if (!urlMatch) { - throw new Error('Invalid GitHub URL'); - } - - const [, owner, repo, path = ''] = urlMatch; - - const apiUrl = `https://api.github.com/repos/${owner}/${repo}`; - const response = await fetch(apiUrl); - - if (!response.ok) { - throw new Error('Repository not found or not public'); - } - - const repoData = await response.json(); - - updateField('repoOwner', owner); - updateField('repoName', repo); - updateField('authorGithub', owner); - updateField('displayName', repoData.name.replace(/-/g, ' ').replace(/\b\w/g, (c: string) => c.toUpperCase())); - updateField('description', repoData.description || ''); - - const slug = path ? path.split('/').filter(Boolean).pop() || repo : repo; - updateField('slug', slug.toLowerCase().replace(/[^a-z0-9-]/g, '-')); - - if (repoData.topics && repoData.topics.length > 0) { - updateField('tags', repoData.topics.slice(0, 5).join(', ')); - } else { - const inferredTags: string[] = []; - const nameLC = (repo + ' ' + (repoData.description || '')).toLowerCase(); - if (nameLC.includes('react')) inferredTags.push('react'); - if (nameLC.includes('typescript') || nameLC.includes('ts')) inferredTags.push('typescript'); - if (nameLC.includes('python')) inferredTags.push('python'); - if (nameLC.includes('skill')) inferredTags.push('skills'); - if (inferredTags.length > 0) { - updateField('tags', inferredTags.join(', ')); - } - } - - updateField('skillContent', `[Linked from GitHub: ${owner}/${repo}]`); - updateField('skillPath', path || '/'); - - } catch (err) { - setDetectError(err instanceof Error ? err.message : 'Detection failed'); - } finally { - setIsDetecting(false); + await navigator.clipboard.writeText(command); + setCopied(true); + setTimeout(() => setCopied(false), 2000); + } catch { + // ignore } } - const handleDragOver = useCallback(function(e: React.DragEvent): void { - e.preventDefault(); - setIsDragging(true); - }, []); - - const handleDragLeave = useCallback(function(e: React.DragEvent): void { - e.preventDefault(); - setIsDragging(false); - }, []); - - const processMarkdownFile = useCallback(function(file: File): void { - setFileName(file.name); - const reader = new FileReader(); - reader.onload = (event) => { - parseSkillContent(event.target?.result as string); - }; - reader.readAsText(file); - }, []); - - const handleDrop = useCallback(function(e: React.DragEvent): void { - e.preventDefault(); - setIsDragging(false); - - const files = Array.from(e.dataTransfer.files); - const mdFile = files.find(f => f.name.endsWith('.md')); - - if (mdFile) { - processMarkdownFile(mdFile); - } - }, [processMarkdownFile]); - - function handleFileSelect(e: React.ChangeEvent): void { - const file = e.target.files?.[0]; - if (file && file.name.endsWith('.md')) { - processMarkdownFile(file); - } - } - - const validation = { - slug: !form.slug ? 'Slug is required.' : null, - displayName: !form.displayName ? 'Display name is required.' : null, - content: mode === 'upload' && !form.skillContent ? 'Upload a SKILL.md file.' : null, - repo: mode === 'import' && (!form.repoOwner || !form.repoName) ? 'Click Detect to import repo.' : null, - tags: !form.tags ? 'Add at least one tag.' : null, - }; - - const isImported = mode === 'import' && form.repoOwner && form.repoName; - const errors = Object.values(validation).filter(Boolean); - const isValid = errors.length === 0; - const tagsArray = form.tags.split(',').map(t => t.trim()).filter(Boolean); - - function generateIssueUrl(): string { - const skillId = form.repoOwner && form.repoName - ? `${form.repoOwner}/${form.repoName}/${form.slug}` - : `community/${form.authorGithub || 'anonymous'}/${form.slug}`; - - const jsonEntry = JSON.stringify({ - id: skillId, - name: form.displayName, - description: form.description || '', - source: `${form.repoOwner}/${form.repoName}`, - tags: tagsArray, - author: form.authorGithub || form.repoOwner - }, null, 2); - - const title = isImported - ? encodeURIComponent(`[Import] ${form.repoOwner}/${form.repoName}`) - : encodeURIComponent(`[Skill] ${form.displayName}`); - - const bodyContent = isImported - ? `## 📦 Import Request: ${form.repoOwner}/${form.repoName} - -### Repository -🔗 https://github.com/${form.repoOwner}/${form.repoName} - -### Add to \`marketplace/skills.json\` - -\`\`\`json -${jsonEntry} -\`\`\` - -### Checklist for Maintainer -- [ ] Verify repository is public -- [ ] Add JSON entry to \`marketplace/skills.json\` - ---- -**Submitted by:** @${form.authorGithub || 'anonymous'} -**Owner:** @${form.repoOwner} (retains all rights)` - : `## 📤 Skill Upload: ${form.displayName} - -### Add to \`marketplace/skills.json\` - -\`\`\`json -${jsonEntry} -\`\`\` - -### SKILL.md Content - -
-Click to expand - -\`\`\`markdown -${form.skillContent.slice(0, 4000)}${form.skillContent.length > 4000 ? '\n...(truncated)' : ''} -\`\`\` - -
- -### Checklist for Maintainer -- [ ] Review SKILL.md content -- [ ] Add JSON entry to \`marketplace/skills.json\` - ---- -**Author:** @${form.authorGithub || 'anonymous'}`; - - const body = encodeURIComponent(bodyContent); - const labels = isImported ? 'skill-import' : 'skill-submission'; - return `https://github.com/rohitg00/skillkit/issues/new?title=${title}&body=${body}&labels=${labels}`; - } - - function handleSubmitClick(e: React.MouseEvent): void { - e.preventDefault(); - if (isValid) { - const url = generateIssueUrl(); - window.open(url, '_blank', 'noopener,noreferrer'); - } - } + const issueUrl = repoUrl + ? `https://github.com/rohitg00/skillkit/issues/new?title=${encodeURIComponent(`[Skill] ${owner}/${repo}`)}&body=${encodeURIComponent(`## Skill Submission\n\n**Repository:** ${repoUrl}\n\n**Description:** \n\n**Tags:** `)}&labels=skill-submission` + : 'https://github.com/rohitg00/skillkit/issues/new?template=skill-submission.md'; return ( -
-
- - -
- -
-
- {mode === 'import' && ( - -
- - Repo, tree path, or blob -
-
- setGithubUrl(e.target.value)} - placeholder="https://github.com/owner/repo" - className="flex-1 bg-zinc-900 border border-zinc-700 text-white px-4 py-2.5 font-mono text-sm focus:ring-1 focus:ring-white focus:border-white outline-none placeholder-zinc-600" - /> - -
- {detectError && ( -

{detectError}

- )} - {isImported && ( -

- - - - Repository detected - {form.repoOwner}/{form.repoName} -

- )} -

- Public repos only. We link to the original - owner retains all rights. -

-
- )} - - {mode === 'upload' && ( - -
-
- - - -
-

- {fileName ? ( - {fileName} - ) : ( - 'Drop SKILL.md here' - )} -

-

or

- -
-
- )} - - -
-
-
- - updateField('slug', e.target.value.toLowerCase().replace(/[^a-z0-9-]/g, ''))} - placeholder="my-skill" - className="w-full bg-zinc-900 border border-zinc-700 text-white px-3 py-2 font-mono text-sm focus:ring-1 focus:ring-white focus:border-white outline-none placeholder-zinc-600" - /> -
-
- - updateField('displayName', e.target.value)} - placeholder="My Skill" - className="w-full bg-zinc-900 border border-zinc-700 text-white px-3 py-2 font-mono text-sm focus:ring-1 focus:ring-white focus:border-white outline-none placeholder-zinc-600" - /> -
-
- -
-
- - updateField('version', e.target.value)} - placeholder="1.0.0" - className="w-full bg-zinc-900 border border-zinc-700 text-white px-3 py-2 font-mono text-sm focus:ring-1 focus:ring-white focus:border-white outline-none placeholder-zinc-600" - /> -
-
- - updateField('tags', e.target.value)} - placeholder="react, typescript" - className="w-full bg-zinc-900 border border-zinc-700 text-white px-3 py-2 font-mono text-sm focus:ring-1 focus:ring-white focus:border-white outline-none placeholder-zinc-600" - /> -
-
- -
- {TAG_SUGGESTIONS.map((tag) => ( - - ))} -
-
-
+
+
+
+ + setRepoUrl(e.target.value)} + placeholder="https://github.com/username/my-skill" + className="w-full bg-zinc-900 border border-zinc-800 text-white px-4 py-3 font-mono text-sm focus:border-zinc-600 outline-none placeholder-zinc-600" + />
-
- -

Preview

-
-
-
-
- {form.displayName || 'Skill Name'} -
-

- {form.description || 'No description'} -

-
- - v{form.version} - -
- {(form.repoOwner || form.authorGithub) && ( -
- {form.repoOwner && form.repoName && {form.repoOwner}/{form.repoName}} - {form.authorGithub && ( - <> - {form.repoOwner && •} - @{form.authorGithub} - - )} -
- )} - {tagsArray.length > 0 && ( -
- {tagsArray.map((tag, i) => ( - - {tag} - - ))} -
- )} -
-
+
+
+ Run this command + +
+ + $ {command} + +
- {isImported ? ( - -
-
- - - -
-
-

Linked Repository

-

Skills hosted by @{form.repoOwner}

-
-
- - github.com/{form.repoOwner}/{form.repoName} - - - - -
- ) : form.skillContent && !form.skillContent.startsWith('[Linked') ? ( - -

SKILL.md

-
-                {form.skillContent.slice(0, 1000)}
-                {form.skillContent.length > 1000 && '\n...'}
-              
-
- ) : null} - - {errors.length > 0 && ( -
- {errors.map((error, i) => ( -
- • {error} -
- ))} -
- )} - - - -

- {isImported - ? 'Links to original repo → Owner retains rights' - : 'Opens GitHub issue → We review → Added to marketplace'} -

+ open a GitHub issue +
diff --git a/docs/skillkit/components/StackBuilder.tsx b/docs/skillkit/components/StackBuilder.tsx index a4539f20..b318e3f5 100644 --- a/docs/skillkit/components/StackBuilder.tsx +++ b/docs/skillkit/components/StackBuilder.tsx @@ -13,19 +13,39 @@ const POPULAR_STACKS = [ }, { name: 'AI/ML Development', - skills: ['python', 'langchain', 'openai', 'embeddings'], + skills: ['python', 'langchain', 'openai', 'embeddings', 'llm'], icon: '🤖', }, { name: 'DevOps & Cloud', - skills: ['docker', 'kubernetes', 'terraform', 'github-actions'], + skills: ['docker', 'kubernetes', 'terraform', 'github-actions', 'kubernetes-mcp'], icon: '☁️', }, { name: 'Mobile Development', - skills: ['react-native', 'expo', 'ios', 'android'], + skills: ['react-native', 'expo', 'ios', 'android', 'swift'], icon: '📱', }, + { + name: 'Backend & API', + skills: ['nodejs', 'express', 'graphql', 'rest', 'nestjs'], + icon: '🔧', + }, + { + name: 'Security', + skills: ['security', 'auth', 'oauth', 'jwt', 'vulnerability'], + icon: '🔒', + }, + { + name: 'Data Engineering', + skills: ['sql', 'postgres', 'redis', 'elasticsearch', 'kafka'], + icon: '📊', + }, + { + name: 'Web3 & Blockchain', + skills: ['solidity', 'ethereum', 'web3', 'smart-contract'], + icon: '⛓️', + }, ]; export function StackBuilder(): React.ReactElement { @@ -186,42 +206,39 @@ export function StackBuilder(): React.ReactElement { )}
-
-
-
- Install Command -
+
+
{stack.length > 0 ? ( <> -
-                    
+                  
+                    
                       {generateInstallCommand()}
                     
                   
) : ( -
- Add skills to generate install command +
+ Add skills to generate command
)}
diff --git a/marketplace/skills.json b/marketplace/skills.json index 7a12d3a5..c524331a 100644 --- a/marketplace/skills.json +++ b/marketplace/skills.json @@ -2,7 +2,7 @@ "$schema": "./schema.json", "version": 1, "updatedAt": "2026-01-26", - "totalSkills": 15062, + "totalSkills": 15064, "curatedCollections": 31, "skills": [ { @@ -354,6 +354,19 @@ "react" ] }, + { + "id": "rohitg00/skillkit/find-skills", + "name": "Find Skills", + "description": "Universal skill discovery across all AI agent marketplaces. Search 15K+ skills and install with one command.", + "source": "rohitg00/skillkit", + "tags": [ + "meta", + "discovery", + "marketplace", + "skills", + "find-skills" + ] + }, { "id": "anthropics/skills/frontend-design", "name": "Frontend Design", @@ -33085,6 +33098,20 @@ "source": "oldwinter/skills", "tags": [] }, + { + "id": "rohitg00/kubectl-mcp-server/kubernetes-mcp", + "name": "Kubernetes MCP Server", + "description": "MCP server for Kubernetes with 127+ tools, 8 resources, 8 prompts. Full cluster management via Claude/Cursor.", + "source": "rohitg00/kubectl-mcp-server", + "tags": [ + "kubernetes", + "mcp", + "kubernetes-mcp", + "devops", + "kubectl", + "k8s" + ] + }, { "id": "itsmostafa/aws-agent-skills/cognito", "name": "Cognito", diff --git a/scripts/bump-version.sh b/scripts/bump-version.sh index cfaad748..a69e0d1c 100755 --- a/scripts/bump-version.sh +++ b/scripts/bump-version.sh @@ -36,6 +36,22 @@ for pkg in "${PACKAGES[@]}"; do fi done +echo "" +echo "Updating hardcoded versions in website..." + +HERO_FILE="docs/skillkit/components/Hero.tsx" +if [ -f "$HERO_FILE" ]; then + sed -i '' "s/v[0-9]\+\.[0-9]\+\.[0-9]\+<\/span>/v$VERSION<\/span>/" "$HERO_FILE" + echo "✓ Updated $HERO_FILE" +fi + +APP_FILE="docs/skillkit/App.tsx" +if [ -f "$APP_FILE" ]; then + sed -i '' "s/>v[0-9]\+\.[0-9]\+\.[0-9]\+<\/span>/>v$VERSION<\/span>/" "$APP_FILE" + sed -i '' "s/\">[0-9]\+\.[0-9]\+\.[0-9]\+<\/span>/\">$VERSION<\/span>/" "$APP_FILE" + echo "✓ Updated $APP_FILE" +fi + echo "" echo "All packages updated to version $VERSION" echo "" diff --git a/skills/find-skills/SKILL.md b/skills/find-skills/SKILL.md new file mode 100644 index 00000000..a211dac3 --- /dev/null +++ b/skills/find-skills/SKILL.md @@ -0,0 +1,137 @@ +--- +name: "find-skills" +description: "Discover and install skills from multiple marketplaces for AI coding agents" +version: "1.0.0" +tags: ["meta", "discovery", "marketplace", "skills"] +--- + +# Find Skills + +Universal skill discovery across all AI agent skill marketplaces. + +## When to Use + +Use this skill when the user: +- Asks "how do I do X" where X might have an existing skill +- Says "find a skill for X" or "is there a skill that can..." +- Wants to extend agent capabilities with specialized knowledge +- Mentions a domain (testing, deployment, design, security, etc.) + +## SkillKit CLI Commands + +```bash +# Search skills +npx skillkit@latest find + +# Install from GitHub +npx skillkit@latest install + +# Browse TUI marketplace +npx skillkit@latest marketplace + +# List installed skills +npx skillkit@latest list + +# Get recommendations based on your project +npx skillkit@latest recommend +``` + +## Skill Sources (15,000+ skills) + +### Official Partners +| Source | Install | +|--------|---------| +| Anthropic | `npx skillkit@latest install anthropics/skills` | +| Vercel | `npx skillkit@latest install vercel-labs/agent-skills` | +| Expo | `npx skillkit@latest install expo/skills` | +| Remotion | `npx skillkit@latest install remotion-dev/skills` | +| Supabase | `npx skillkit@latest install supabase/agent-skills` | +| Stripe | `npx skillkit@latest install stripe/ai` | + +### Community Collections +| Source | Focus | +|--------|-------| +| `trailofbits/skills` | Security, auditing | +| `obra/superpowers` | TDD, workflow | +| `wshobson/agents` | Dev patterns | +| `ComposioHQ/awesome-claude-skills` | Curated collection | +| `langgenius/dify` | AI platform | +| `better-auth/skills` | Authentication | +| `elysiajs/skills` | Bun/ElysiaJS | +| `rohitg00/kubectl-mcp-server` | Kubernetes MCP | + +## How to Help Users + +### Step 1: Understand the Need +Identify: +1. Domain (React, testing, DevOps, security, etc.) +2. Specific task (writing tests, deployment, code review) +3. Technology stack + +### Step 2: Search for Skills + +Run search with relevant keywords: +```bash +npx skillkit@latest find "react testing" +npx skillkit@latest find "kubernetes" +npx skillkit@latest find "security audit" +``` + +### Step 3: Present Results + +When you find skills, show: +1. Skill name and description +2. The install command +3. Source repository + +Example response: +``` +Found: "React Best Practices" from Vercel Labs +- React and Next.js patterns from Vercel Engineering + +Install: +npx skillkit@latest install vercel-labs/agent-skills +``` + +### Step 4: Install + +Install for the user: +```bash +npx skillkit@latest install +``` + +Or install specific skill: +```bash +npx skillkit@latest install --skill +``` + +## Common Searches + +| Need | Search Query | +|------|--------------| +| React patterns | `npx skillkit@latest find react` | +| Testing | `npx skillkit@latest find testing jest` | +| TypeScript | `npx skillkit@latest find typescript` | +| DevOps | `npx skillkit@latest find docker kubernetes` | +| Security | `npx skillkit@latest find security` | +| API design | `npx skillkit@latest find api rest graphql` | +| Mobile | `npx skillkit@latest find react-native expo` | +| Database | `npx skillkit@latest find postgres prisma` | + +## When No Skills Found + +If no matching skill exists: +1. Offer to help directly with your capabilities +2. Suggest creating a custom skill: + ```bash + npx skillkit@latest init my-skill + ``` +3. Recommend publishing to share with others: + ```bash + npx skillkit@latest publish + ``` + +## Browse Online + +- Website: https://agentskills.com +- GitHub: https://github.com/rohitg00/skillkit