Compare commits

...
25 Commits
Author SHA1 Message Date
Rohit Ghumare 6916c09962 chore: bump version to 1.7.2 2026-01-27 11:04:31 +00:00
Rohit Ghumare 41da423306 feat(ci): add GitHub Packages publishing (#16)
* feat(ci): add GitHub Packages publishing

Adds a new job to publish the main skillkit package to GitHub Packages
(npm.pkg.github.com) as @rohitg00/skillkit after successful npm publish.

- Publish to npm first, then GitHub Packages
- Uses GITHUB_TOKEN for authentication (no additional secrets needed)
- Package available at npm.pkg.github.com/@rohitg00/skillkit

* docs: add GitHub Packages installation instructions

* fix(ci): resolve workspace dependencies before GitHub Packages publish
2026-01-27 10:55:02 +00:00
Rohit Ghumare c5e78b7f83 fix(website): standardize layout to max-w-5xl for consistent alignment 2026-01-27 00:10:38 +00:00
Rohit Ghumare 438bc2720a feat(website): replace npx command with npm logo link in navbar 2026-01-27 00:07:49 +00:00
Rohit Ghumare 85d9eee7e9 chore: bump version to 1.7.1 2026-01-27 00:06:13 +00:00
Rohit Ghumare d14b57c651 Update README.md 2026-01-27 00:04:17 +00:00
Rohit Ghumare 4a6003ec46 feat: single source of truth for skills marketplace (#15)
* feat: single source of truth for skills marketplace

- Consolidate all skills data to marketplace/skills.json (15,062 skills)
- Add marketplace/sources.json for curated repository sources (31 repos)
- Add skillkit publish command for user skill submissions
- Add auto-publish prompt to skillkit init
- Add AI skill caching with localStorage (7-day TTL)
- Add Submit to Marketplace button for AI-generated skills
- Remove duplicate skills.json files (docs, core)
- Remove legacy src/tui/ folder (replaced by packages/tui)
- Update all imports to use single source files

* fix: address CodeRabbit review feedback

- Remove duplicate checklist items in SkillSubmitForm.tsx
- Add missing sources-schema.json file
- Add slugify method for URL-safe skill IDs
- Fix Windows browser open command (empty title param)
- Fix frontmatter parsing for CRLF and multiline tags

* fix: address additional review feedback

- Add TTY check to skip prompts in CI/non-interactive environments
- Guard against empty slug IDs with validation
- Print full URL in fallback (not truncated)
- Fix repo name parsing for names containing dots
- Add cache pruning and max entries limit (50) for localStorage

* fix: filter empty strings from YAML tags array parsing
2026-01-27 00:02:40 +00:00
Rohit Ghumare 6d36a4a3f7 Revert "feat: single source of truth for skills marketplace"
This reverts commit 0c5eb93891.
2026-01-26 23:15:14 +00:00
Rohit Ghumare 0c5eb93891 feat: single source of truth for skills marketplace
- Consolidate all skills data to marketplace/skills.json (15,062 skills)
- Add marketplace/sources.json for curated repository sources (31 repos)
- Add skillkit publish command for user skill submissions
- Add auto-publish prompt to skillkit init
- Add AI skill caching with localStorage (7-day TTL)
- Add Submit to Marketplace button for AI-generated skills
- Remove duplicate skills.json files (docs, core)
- Remove legacy src/tui/ folder (replaced by packages/tui)
- Update all imports to use single source files
2026-01-26 23:12:23 +00:00
Rohit Ghumare 2432410f79 feat: add OG image and meta tags for social preview
- Add og-image.png for social media previews
- Add Open Graph meta tags (title, description, image, url)
- Add Twitter Card meta tags (summary_large_image)
- Add meta description for SEO
2026-01-26 21:14:37 +00:00
Rohit Ghumare 4e3e2b3145 fix: alignment and npx skillkit@latest
- Hero: use items-start for proper top alignment
- Agents: add pl-8 padding to prevent first icon cutoff
- Update all npx commands to use skillkit@latest
2026-01-26 21:07:24 +00:00
Rohit Ghumare 82e4a2ae62 fix: mobile layout improvements
- Validation errors now stack vertically for better readability
- Footer more compact with smaller padding
- Shorter footer text on mobile
- Better responsive breakpoints (sm instead of md)
2026-01-26 20:58:58 +00:00
Rohit Ghumare ff5b3f7b4b fix: compact npx command button layout
- Use inline-flex for tight button sizing
- Remove unnecessary wrapper div and gradient
- Use flex-wrap for responsive layout
- Reduce spacing for cleaner look
2026-01-26 20:57:54 +00:00
Rohit Ghumare 15134cebbb fix: prevent auto-scroll to Skill Finder on page load
- Remove auto-focus on initial page load
- Only focus input after user interaction (SUCCESS state)
- Use preventScroll option to avoid scroll jumps
2026-01-26 20:51:22 +00:00
Rohit Ghumare 6d01413a68 fix: show GitHub icon on mobile nav 2026-01-26 20:49:35 +00:00
Rohit Ghumare a9d6727ca5 fix: improve mobile layout and add Copied feedback
- Hide terminal animation on mobile (only show on lg screens)
- Add 'Copied!' text feedback when clicking npx command
- Make npx button full width on mobile
- Reduce blank space on mobile hero section
2026-01-26 20:49:05 +00:00
Rohit Ghumare 2078be9eb4 fix: constrain all sections to max-w-5xl for consistent layout
- Add max-w-5xl constraint to Agents scrolling section
- All major sections now have consistent max-width
- Reduces stretched appearance on large monitors
2026-01-26 20:01:04 +00:00
Rohit Ghumare 44da0f8592 fix: use window.open for GitHub issue creation
- Change from anchor tag to button with explicit window.open
- Ensures click handler properly opens GitHub issue URL
- Add disabled state to button when form is invalid
2026-01-26 19:44:44 +00:00
Rohit Ghumare 4089e5a0be fix: tighten layout with max-w-5xl constraints for large screens
- Add max-w-5xl mx-auto to Hero grid container
- Add max-w-5xl mx-auto to Features comparison and feature cards grids
- Set fixed terminal width lg:max-w-[420px] for consistent sizing
- Reduce gap on mobile for better spacing
2026-01-26 19:39:26 +00:00
Rohit Ghumare c564d32ea9 fix: constrain max-width to 6xl for better large screen layout 2026-01-26 19:32:33 +00:00
Rohit Ghumare 4f65aecbc9 fix: improve mobile responsiveness for agents and features sections 2026-01-26 19:27:02 +00:00
Rohit Ghumare c1ba42d616 fix: set base path to root for Vercel deployment 2026-01-26 19:24:01 +00:00
Rohit Ghumare c8172097be feat(marketplace): add community skill submission system (#14)
* feat(marketplace): add community skill submission system

- Add marketplace/skills.json with curated skills collection
- Add marketplace/schema.json for skill validation
- Add marketplace/CONTRIBUTING.md with submission guidelines
- Add skill submission issue template for community contributions
- Add workflow to auto-process approved skill submissions
- Add bundled skills data in core package for offline access

Community members can now submit skills via GitHub Issues, which are
automatically added to the marketplace when approved by maintainers.

* fix: address CodeRabbit review suggestions for marketplace PR

Workflow improvements:
- Add concurrency block to prevent parallel push conflicts
- Fix authorGithub extraction to preserve hyphens in usernames
- Filter empty tags and validate at least one tag exists

Schema improvements:
- Allow dots in repository names (e.g., user/repo.js)
- Copy schema.json to core package data folder for validation

Documentation:
- Add 'text' language tag to code block in CONTRIBUTING.md

Data sync:
- Add skills.json and schema.json to docs/skillkit/data/
2026-01-26 19:20:20 +00:00
Rohit Ghumare 80e41e517c chore: add vercel.json for deployment configuration 2026-01-26 19:20:11 +00:00
Rohit Ghumare 26ea7e9002 refactor(docs): simplify website components and update README (#12)
* refactor(docs): simplify website components and update README

Website Code Simplification:
- Convert arrow functions to named function declarations with explicit return types
- Extract inline styles to module-level constants (BASE_STYLES, VARIANT_STYLES, etc.)
- Extract SVG icons to constants (GITHUB_ICON, CHECK_ICON, COPY_ICON)
- Extract CSS animations to constants (FADE_ANIMATION_STYLES, SCROLL_ANIMATION_STYLES)
- Add explicit TypeScript interfaces (Feature, Agent, TerminalLine, etc.)
- Replace nested ternaries with switch statements for clarity
- Extract inline handlers to named functions (scrollToTop, openGitHub, etc.)
- Improve variable naming (idx -> index, cap -> feature)
- Use meaningful React keys instead of index-only keys

README Updates:
- Remove "What's New in v1.6" section (release notes should be in CHANGELOG)

Components updated:
- App.tsx, Button.tsx, Card.tsx, Terminal.tsx, Footer.tsx
- Features.tsx, Agents.tsx, Hero.tsx
- SkillSubmitForm.tsx, SkillGenerator.tsx

* fix: address CodeRabbit review suggestions

Security:
- Add noopener,noreferrer to window.open in Hero.tsx
- Handle clipboard API errors with try/catch

Accessibility:
- Add Space key support to Card.tsx for keyboard navigation
- Add aria-label to GitHub icon link in Footer.tsx

Error Handling:
- Fix useCallback dependency for processMarkdownFile in SkillSubmitForm
- Add input validation for topic in geminiService.ts

Data Validation:
- Add defensive checks for malformed source URLs in skills-index.ts
- Generate proper skill ID for upload mode in SkillSubmitForm

Type Safety:
- Replace unsafe 'as any' cast with proper type annotation in geminiService

Code Quality:
- Use array filter pattern for class concatenation in Button.tsx
2026-01-26 19:17:21 +00:00
70 changed files with 132089 additions and 1280 deletions
@@ -0,0 +1,89 @@
name: Skill Submission
description: Submit a new skill to the SkillKit marketplace
title: "[Skill Submission] "
labels: ["skill-submission"]
body:
- type: markdown
attributes:
value: |
## Submit Your Skill to SkillKit Marketplace
Thanks for contributing! Please fill out the details below.
**Tip:** You can also use our [web form](https://rohitg00.github.io/skillkit/) to submit skills.
- type: input
id: skill-name
attributes:
label: Skill Name
description: A descriptive name for your skill
placeholder: e.g., React Best Practices
validations:
required: true
- type: textarea
id: description
attributes:
label: Description
description: What does this skill teach AI agents?
placeholder: A brief description of your skill...
validations:
required: true
- type: input
id: repo-owner
attributes:
label: GitHub Owner
description: The owner of the repository (username or organization)
placeholder: e.g., your-username
validations:
required: true
- type: input
id: repo-name
attributes:
label: Repository Name
description: The name of the repository containing the skill
placeholder: e.g., my-agent-skills
validations:
required: true
- type: input
id: skill-path
attributes:
label: Skill Path
description: Path to SKILL.md in the repository
placeholder: skills/my-skill/SKILL.md
validations:
required: true
- type: input
id: tags
attributes:
label: Tags
description: Comma-separated tags for categorization
placeholder: react, typescript, frontend
validations:
required: true
- type: input
id: author-github
attributes:
label: Author GitHub Username
description: Your GitHub username
placeholder: your-username
validations:
required: true
- type: checkboxes
id: checklist
attributes:
label: Checklist
description: Please confirm the following
options:
- label: Repository is public
required: true
- label: SKILL.md follows the agentskills.io standard format
required: true
- label: Skill has been tested with at least one AI agent
required: false
@@ -0,0 +1,180 @@
name: Process Skill Submission
on:
issues:
types: [labeled]
permissions:
contents: write
issues: write
concurrency:
group: process-submission-${{ github.event.issue.number }}
cancel-in-progress: false
jobs:
process-submission:
if: github.event.label.name == 'approved'
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Setup Node.js
uses: actions/setup-node@v4
with:
node-version: '20'
- name: Parse Issue and Update skills.json
uses: actions/github-script@v7
with:
script: |
const fs = require('fs');
const issue = context.payload.issue;
const body = issue.body;
// Parse issue body for skill details
const parseField = (label) => {
const regex = new RegExp(`\\*\\*${label}:\\*\\*\\s*(.+?)(?:\\n|$)`, 'i');
const match = body.match(regex);
return match ? match[1].trim() : '';
};
const parseCheckbox = (text) => {
const regex = new RegExp(`- \\[(x|X)\\]\\s*${text}`, 'i');
return regex.test(body);
};
// Extract fields from form-based issue
let skillName, description, repoOwner, repoName, skillPath, tags, authorGithub;
if (body.includes('### Skill Name')) {
// YAML form format
const sections = body.split('###').filter(s => s.trim());
for (const section of sections) {
const lines = section.trim().split('\n');
const header = lines[0].trim().toLowerCase();
const value = lines.slice(1).join('\n').trim();
if (header.includes('skill name')) skillName = value;
if (header.includes('description')) description = value;
if (header.includes('github owner')) repoOwner = value;
if (header.includes('repository name')) repoName = value;
if (header.includes('skill path')) skillPath = value;
if (header.includes('tags')) tags = value;
if (header.includes('author github')) authorGithub = value;
}
} else {
// Markdown format from web form
skillName = parseField('Name');
description = parseField('Description');
repoOwner = parseField('Owner');
repoName = parseField('Repo');
skillPath = parseField('Skill Path');
tags = parseField('Tags');
const authorField = parseField('Author') || '';
authorGithub = authorField.replace(/^@/, '').trim();
}
if (!skillName || !repoOwner || !repoName) {
console.log('Missing required fields');
await github.rest.issues.createComment({
owner: context.repo.owner,
repo: context.repo.repo,
issue_number: issue.number,
body: '❌ Could not parse skill details. Missing required fields (name, owner, or repo).'
});
return;
}
// Generate skill ID
const skillSlug = skillName.toLowerCase().replace(/\s+/g, '-').replace(/[^a-z0-9-]/g, '');
const skillId = `${repoOwner}/${repoName}/${skillSlug}`;
// Read current skills.json
const skillsPath = 'marketplace/skills.json';
const skillsData = JSON.parse(fs.readFileSync(skillsPath, 'utf-8'));
// Check for duplicates
if (skillsData.skills.some(s => s.id === skillId)) {
await github.rest.issues.createComment({
owner: context.repo.owner,
repo: context.repo.repo,
issue_number: issue.number,
body: `⚠️ Skill with ID \`${skillId}\` already exists in the marketplace.`
});
return;
}
// Parse and validate tags
const filteredTags = tags
? tags.split(',').map(t => t.trim().toLowerCase()).filter(t => t.length > 0)
: [];
if (filteredTags.length === 0) {
await github.rest.issues.createComment({
owner: context.repo.owner,
repo: context.repo.repo,
issue_number: issue.number,
body: '❌ At least one tag is required. Please add tags to your submission.'
});
return;
}
// Add new skill
const newSkill = {
id: skillId,
name: skillName,
description: description || '',
source: `${repoOwner}/${repoName}`,
tags: filteredTags,
author: authorGithub
};
skillsData.skills.push(newSkill);
skillsData.updatedAt = new Date().toISOString().split('T')[0];
// Write updated skills.json
fs.writeFileSync(skillsPath, JSON.stringify(skillsData, null, 2) + '\n');
// Also update docs copy
const docsCopyPath = 'docs/skillkit/data/skills.json';
fs.writeFileSync(docsCopyPath, JSON.stringify(skillsData, null, 2) + '\n');
// Also update core copy
const coreCopyPath = 'packages/core/src/marketplace/data/skills.json';
fs.writeFileSync(coreCopyPath, JSON.stringify(skillsData, null, 2) + '\n');
console.log(`Added skill: ${skillId}`);
// Set output for commit
core.setOutput('skill_name', skillName);
core.setOutput('skill_id', skillId);
- name: Commit Changes
run: |
git config --local user.email "github-actions[bot]@users.noreply.github.com"
git config --local user.name "github-actions[bot]"
git add marketplace/skills.json docs/skillkit/data/skills.json packages/core/src/marketplace/data/skills.json
git commit -m "feat(marketplace): add skill from #${{ github.event.issue.number }}"
git push
- name: Close Issue with Comment
uses: actions/github-script@v7
with:
script: |
await github.rest.issues.createComment({
owner: context.repo.owner,
repo: context.repo.repo,
issue_number: context.payload.issue.number,
body: `✅ **Skill added to marketplace!**\n\nYour skill has been added and will be available in the next release.\n\nThank you for contributing to SkillKit! 🎉`
});
await github.rest.issues.update({
owner: context.repo.owner,
repo: context.repo.repo,
issue_number: context.payload.issue.number,
state: 'closed'
});
+63 -2
View File
@@ -1,4 +1,4 @@
name: Publish to npm
name: Publish to npm and GitHub Packages
on:
push:
@@ -6,7 +6,7 @@ on:
- 'v*'
jobs:
publish:
publish-npm:
runs-on: ubuntu-latest
permissions:
@@ -44,3 +44,64 @@ jobs:
uses: softprops/action-gh-release@v1
with:
generate_release_notes: true
publish-github-packages:
runs-on: ubuntu-latest
needs: publish-npm
permissions:
contents: read
packages: write
steps:
- uses: actions/checkout@v4
- name: Install pnpm
uses: pnpm/action-setup@v4
- name: Setup Node.js for GitHub Packages
uses: actions/setup-node@v4
with:
node-version: '20'
cache: 'pnpm'
registry-url: 'https://npm.pkg.github.com'
scope: '@rohitg00'
- name: Install dependencies
run: pnpm install --frozen-lockfile
- name: Build
run: pnpm build
- name: Configure npm for GitHub Packages
run: |
echo "@rohitg00:registry=https://npm.pkg.github.com" >> .npmrc
echo "//npm.pkg.github.com/:_authToken=${{ secrets.GITHUB_TOKEN }}" >> .npmrc
- name: Publish main skillkit package to GitHub Packages
working-directory: apps/skillkit
run: |
# Create a temporary package.json with GitHub Packages scope and resolved dependencies
node -e "
const fs = require('fs');
const path = require('path');
const pkg = require('./package.json');
pkg.name = '@rohitg00/skillkit';
pkg.publishConfig = { registry: 'https://npm.pkg.github.com' };
// Resolve workspace:* dependencies to actual versions
for (const [dep, version] of Object.entries(pkg.dependencies || {})) {
if (version.startsWith('workspace:')) {
const depName = dep.replace('@skillkit/', '');
const depPkgPath = path.join('..', '..', 'packages', depName, 'package.json');
const depPkg = JSON.parse(fs.readFileSync(depPkgPath, 'utf8'));
pkg.dependencies[dep] = depPkg.version;
}
}
fs.writeFileSync('package.json', JSON.stringify(pkg, null, 2));
"
npm publish
env:
NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+14 -11
View File
@@ -1,8 +1,17 @@
# SkillKit
<div align="center">
```
██ SKILLKIT
```
</div>
**Universal Skills for AI Coding Agents**
[![npm version](https://img.shields.io/npm/v/skillkit.svg)](https://www.npmjs.com/package/skillkit)
[![npm downloads](https://img.shields.io/npm/dm/skillkit.svg)](https://www.npmjs.com/package/skillkit)
[![GitHub Package](https://img.shields.io/badge/GitHub%20Package-@rohitg00/skillkit-blue?logo=github)](https://github.com/rohitg00/skillkit/pkgs/npm/skillkit)
[![CI](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml/badge.svg)](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml)
[![Website](https://img.shields.io/badge/Website-skillkit-black)](https://rohitg00.github.io/skillkit/)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
## Supercharge Every AI Coding Agent
@@ -51,16 +60,6 @@ skillkit recommend
| **Session Memory** | Knowledge dies with each session | Persistent learning across agents |
| **Skill Testing** | Hope it works | Test framework with assertions |
## What's New in v1.6
- **Recursive Agent Translation**: Batch translate entire directories of agents with `--recursive` flag
- **Custom AI Sub-Agents**: Create, translate, sync, and validate custom AI sub-agents across 17 coding agents
- **Methodology Framework**: 5 ready-to-use frameworks (Agile, TDD, DevOps, Security-First, Documentation-First)
- **Hooks System**: Event-driven skill triggers - auto-activate on commits, file changes, builds
- **Agent Orchestration**: Multi-agent team coordination with leader/teammate roles
- **Plan System**: Parse, validate, and execute structured development plans
- **Slash Commands**: Generate agent-native `/commands` from natural language
## 5-Minute Quick Start
```bash
@@ -426,6 +425,9 @@ bun add -g skillkit
# npx (no install)
npx skillkit <command>
# GitHub Packages (alternative registry)
npm install -g @rohitg00/skillkit --registry=https://npm.pkg.github.com
```
## Configuration
@@ -456,3 +458,4 @@ Contributions welcome! Please read our [Contributing Guidelines](CONTRIBUTING.md
- [Agent Skills Specification](https://agentskills.io/specification)
- [GitHub Repository](https://github.com/rohitg00/skillkit)
- [NPM Package](https://www.npmjs.com/package/skillkit)
- [GitHub Package](https://github.com/rohitg00/skillkit/pkgs/npm/skillkit)
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "skillkit",
"version": "1.7.0",
"version": "1.7.2",
"description": "Supercharge AI coding agents with portable skills. Install, translate, and share skills across Claude Code, Cursor, Codex, Copilot & 13 more",
"type": "module",
"bin": {
+2
View File
@@ -39,6 +39,7 @@ import {
CommandCmd,
AICommand,
AuditCommand,
PublishCommand,
AgentCommand,
AgentListCommand,
AgentShowCommand,
@@ -98,6 +99,7 @@ cli.register(PlanCommand);
cli.register(CommandCmd);
cli.register(AICommand);
cli.register(AuditCommand);
cli.register(PublishCommand);
cli.register(AgentCommand);
cli.register(AgentListCommand);
cli.register(AgentShowCommand);
+24
View File
@@ -0,0 +1,24 @@
# Logs
logs
*.log
npm-debug.log*
yarn-debug.log*
yarn-error.log*
pnpm-debug.log*
lerna-debug.log*
node_modules
dist
dist-ssr
*.local
# Editor directories and files
.vscode/*
!.vscode/extensions.json
.idea
.DS_Store
*.suo
*.ntvs*
*.njsproj
*.sln
*.sw?
+85
View File
@@ -0,0 +1,85 @@
import React from 'react';
import { Hero } from './components/Hero';
import { Features } from './components/Features';
import { Agents } from './components/Agents';
import { Footer } from './components/Footer';
import { SkillGenerator } from './components/SkillGenerator';
import { SkillSubmitForm } from './components/SkillSubmitForm';
const GITHUB_ICON = (
<svg className="w-5 h-5" fill="currentColor" viewBox="0 0 24 24">
<path fillRule="evenodd" d="M12 2C6.477 2 2 6.484 2 12.017c0 4.425 2.865 8.18 6.839 9.504.5.092.682-.217.682-.483 0-.237-.008-.868-.013-1.703-2.782.605-3.369-1.343-3.369-1.343-.454-1.158-1.11-1.466-1.11-1.466-.908-.62.069-.608.069-.608 1.003.07 1.531 1.032 1.531 1.032.892 1.53 2.341 1.088 2.91.832.092-.647.35-1.088.636-1.338-2.22-.253-4.555-1.113-4.555-4.951 0-1.093.39-1.988 1.029-2.688-.103-.253-.446-1.272.098-2.65 0 0 .84-.27 2.75 1.026A9.564 9.564 0 0112 6.844c.85.004 1.705.115 2.504.337 1.909-1.296 2.747-1.027 2.747-1.027.546 1.379.202 2.398.1 2.651.64.7 1.028 1.595 1.028 2.688 0 3.848-2.339 4.695-4.566 4.943.359.309.678.92.678 1.855 0 1.338-.012 2.419-.012 2.747 0 .268.18.58.688.482A10.019 10.019 0 0022 12.017C22 6.484 17.522 2 12 2z" clipRule="evenodd" />
</svg>
);
const NPM_ICON = (
<svg className="w-5 h-5" viewBox="0 0 24 24" fill="currentColor">
<path d="M0 7.334v8h6.666v1.332H12v-1.332h12v-8H0zm6.666 6.664H5.334v-4H3.999v4H1.335V8.667h5.331v5.331zm4 0v1.336H8.001V8.667h5.334v5.332h-2.669v-.001zm12.001 0h-1.33v-4h-1.336v4h-1.335v-4h-1.33v4h-2.671V8.667h8.002v5.331zM10.665 10H12v2.667h-1.335V10z" />
</svg>
);
function scrollToTop(e: React.MouseEvent): void {
e.preventDefault();
window.scrollTo({ top: 0, behavior: 'smooth' });
}
export default function App(): React.ReactElement {
return (
<div className="min-h-screen bg-background text-zinc-100 font-sans selection:bg-white selection:text-black">
<nav className="fixed top-0 left-0 right-0 z-50 border-b border-zinc-800 bg-background/90 backdrop-blur-md">
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
<div className="flex h-14 items-center justify-between">
<a href="#" onClick={scrollToTop} className="flex items-center gap-2 cursor-pointer">
<div className="w-4 h-4 bg-white"></div>
<span className="text-base font-bold tracking-tight text-white font-mono">SKILLKIT</span>
</a>
<div className="flex items-center gap-2 sm:gap-4">
<a
href="https://www.npmjs.com/package/skillkit"
target="_blank"
rel="noreferrer"
className="text-zinc-400 hover:text-red-500 transition-colors p-2"
aria-label="npm"
>
{NPM_ICON}
</a>
<a
href="https://github.com/rohitg00/skillkit"
target="_blank"
rel="noreferrer"
className="text-zinc-400 hover:text-white transition-colors p-2"
aria-label="GitHub"
>
{GITHUB_ICON}
</a>
</div>
</div>
</div>
</nav>
<main className="pt-14">
<Hero />
<Agents />
<Features />
<section id="skills" className="py-12 border-b border-zinc-800">
<SkillGenerator />
</section>
<section id="submit" className="py-12 border-b border-zinc-800 bg-surface">
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
<div className="text-center mb-8">
<h2 className="text-2xl font-bold text-white mb-2 font-mono">Submit Your Skill</h2>
<p className="text-zinc-400 font-mono text-sm">
Share your AI agent skills with the community.
</p>
</div>
<SkillSubmitForm />
</div>
</section>
</main>
<Footer />
</div>
);
}
+39
View File
@@ -0,0 +1,39 @@
# SkillKit Documentation Website
Landing page for SkillKit - the universal CLI for managing AI agent skills.
**Live site:** https://rohitg00.github.io/skillkit/
## Development
**Prerequisites:** Node.js 20+
1. Install dependencies:
```bash
npm install
```
2. (Optional) Set `GEMINI_API_KEY` in `.env.local` for the skill generator feature
3. Run locally:
```bash
npm run dev
```
4. Build for production:
```bash
npm run build
```
## Deployment
The site is automatically deployed to GitHub Pages when changes are pushed to the `main` branch.
The deployment workflow is defined in `.github/workflows/deploy-docs.yml`.
## Tech Stack
- React 19
- Vite
- Tailwind CSS (via CDN)
- TypeScript
File diff suppressed because one or more lines are too long
+53
View File
@@ -0,0 +1,53 @@
import React from 'react';
interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
variant?: 'primary' | 'secondary' | 'outline' | 'ghost';
fullWidth?: boolean;
isLoading?: boolean;
}
const BASE_STYLES = "inline-flex items-center justify-center px-6 py-3 text-sm font-medium transition-all duration-200 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-offset-black disabled:opacity-50 font-mono tracking-tight";
const VARIANT_STYLES = {
primary: "bg-white text-black hover:bg-zinc-200 border border-white",
secondary: "bg-zinc-900 text-zinc-100 hover:bg-zinc-800 border border-zinc-800",
outline: "bg-transparent text-zinc-300 border border-zinc-700 hover:border-zinc-500 hover:text-white",
ghost: "bg-transparent text-zinc-400 hover:text-white hover:bg-zinc-900"
} as const;
export function Button({
children,
variant = 'primary',
className = '',
fullWidth = false,
isLoading = false,
disabled,
...props
}: ButtonProps): React.ReactElement {
const widthClass = fullWidth ? 'w-full' : '';
const classes = [
BASE_STYLES,
VARIANT_STYLES[variant],
widthClass,
className,
].filter(Boolean).join(' ');
return (
<button
className={classes}
disabled={disabled || isLoading}
{...props}
>
{isLoading ? (
<>
<svg className="animate-spin -ml-1 mr-2 h-4 w-4" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24">
<circle className="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" strokeWidth="4"></circle>
<path className="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4zm2 5.291A7.962 7.962 0 014 12H0c0 3.042 1.135 5.824 3 7.938l3-2.647z"></path>
</svg>
PROCESSING
</>
) : children}
</button>
);
}
+49
View File
@@ -0,0 +1,49 @@
import React from 'react';
interface CardProps {
children: React.ReactNode;
className?: string;
noPadding?: boolean;
onClick?: () => void;
onDragOver?: (e: React.DragEvent) => void;
onDragLeave?: (e: React.DragEvent) => void;
onDrop?: (e: React.DragEvent) => void;
}
export function Card({
children,
className = '',
noPadding = false,
onClick,
onDragOver,
onDragLeave,
onDrop
}: CardProps): React.ReactElement {
const paddingClass = noPadding ? '' : 'p-6';
const clickableClass = onClick ? 'cursor-pointer' : '';
function handleKeyDown(e: React.KeyboardEvent): void {
if (!onClick) return;
if (e.key === 'Enter' || e.key === ' ') {
if (e.key === ' ') {
e.preventDefault();
}
onClick();
}
}
return (
<div
className={`relative bg-black border border-zinc-800 transition-colors duration-300 ${paddingClass} ${clickableClass} ${className}`}
onClick={onClick}
role={onClick ? 'button' : undefined}
tabIndex={onClick ? 0 : undefined}
onKeyDown={onClick ? handleKeyDown : undefined}
onDragOver={onDragOver}
onDragLeave={onDragLeave}
onDrop={onDrop}
>
{children}
</div>
);
}
+144
View File
@@ -0,0 +1,144 @@
import React from 'react';
interface Feature {
title: string;
description: string;
icon: React.ReactNode;
}
const FEATURES: Feature[] = [
{
title: 'Multi-Agent',
description: 'Write once, deploy to 17+ AI coding agents automatically.',
icon: (
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M19 11H5m14 0a2 2 0 012 2v6a2 2 0 01-2 2H5a2 2 0 01-2-2v-6a2 2 0 012-2m14 0V9a2 2 0 00-2-2M5 11V9a2 2 0 012-2m0 0V5a2 2 0 012-2h6a2 2 0 012 2v2M7 7h10" />
</svg>
)
},
{
title: 'Smart Discovery',
description: 'AI analyzes your stack and recommends skills.',
icon: (
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z" />
</svg>
)
},
{
title: 'Persistent Memory',
description: 'Save learnings as reusable skills.',
icon: (
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M9 3v2m6-2v2M9 19v2m6-2v2M5 9H3m2 6H3m18-6h-2m2 6h-2M7 19h10a2 2 0 002-2V7a2 2 0 00-2-2H7a2 2 0 00-2 2v10a2 2 0 002 2zM9 9h6v6H9V9z" />
</svg>
)
},
{
title: 'Team Sync',
description: 'Share skills via Git across your team.',
icon: (
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M17 20h5v-2a3 3 0 00-5.356-1.857M17 20H7m10 0v-2c0-.656-.126-1.283-.356-1.857M7 20H2v-2a3 3 0 015.356-1.857M7 20v-2c0-.656.126-1.283.356-1.857m0 0a5.002 5.002 0 019.288 0M15 7a3 3 0 11-6 0 3 3 0 016 0zm6 3a2 2 0 11-4 0 2 2 0 014 0zM7 10a2 2 0 11-4 0 2 2 0 014 0z" />
</svg>
)
},
{
title: 'Testing',
description: 'Built-in framework for skill validation.',
icon: (
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z" />
</svg>
)
},
{
title: 'Workflows',
description: 'Compose multi-step automated pipelines.',
icon: (
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M13 10V3L4 14h7v7l9-11h-7z" />
</svg>
)
}
];
const COMPARISONS = [
['Agents', '1', '17+'],
['Translation', 'Manual', 'Auto'],
['Sharing', 'Copy/paste', 'Git sync'],
['Discovery', 'Forums', 'AI-powered'],
] as const;
export function Features(): React.ReactElement {
return (
<section id="features" className="py-12 border-b border-zinc-800 bg-surface">
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
<div className="grid grid-cols-1 lg:grid-cols-5 gap-6 lg:gap-8 mb-10">
<div className="lg:col-span-2">
<h2 className="text-xl font-bold text-white mb-2 font-mono">Why SkillKit?</h2>
<p className="text-zinc-500 font-mono text-sm mb-6">
Universal bridge for AI coding agents.
</p>
<div className="flex gap-6 sm:gap-8">
<div>
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">17+</div>
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Agents</div>
</div>
<div>
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">1</div>
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Command</div>
</div>
<div>
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">∞</div>
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Skills</div>
</div>
</div>
</div>
<div className="lg:col-span-3 border border-zinc-800 bg-black/50 p-4 font-mono text-xs backdrop-blur-sm">
<div className="grid grid-cols-3 gap-2 border-b border-zinc-800 pb-2 mb-3 text-zinc-500 uppercase tracking-wider text-[10px]">
<div>Feature</div>
<div className="text-center">Without</div>
<div className="text-right">SkillKit</div>
</div>
<div className="space-y-1">
{COMPARISONS.map(([feature, without, withSkillKit], index) => (
<div
key={feature}
className="grid grid-cols-3 gap-2 items-center py-1.5 hover:bg-zinc-900/50 transition-colors -mx-2 px-2 rounded"
style={{ animationDelay: `${index * 100}ms` }}
>
<div className="text-zinc-300">{feature}</div>
<div className="text-center text-zinc-600">{without}</div>
<div className="text-right text-white font-medium">{withSkillKit}</div>
</div>
))}
</div>
</div>
</div>
<div className="grid grid-cols-1 xs:grid-cols-2 md:grid-cols-3 lg:grid-cols-6 gap-3">
{FEATURES.map((feature, index) => (
<div
key={feature.title}
className="group relative p-4 border border-zinc-800 bg-zinc-900/30 hover:bg-zinc-900/80 hover:border-zinc-700 transition-all duration-300 cursor-default"
style={{ animationDelay: `${index * 50}ms` }}
>
<div className="absolute inset-0 bg-gradient-to-b from-zinc-800/0 to-zinc-800/20 opacity-0 group-hover:opacity-100 transition-opacity"></div>
<div className="relative">
<div className="text-zinc-500 group-hover:text-white transition-colors mb-2">
{feature.icon}
</div>
<h4 className="text-xs font-bold text-white mb-1 font-mono">{feature.title}</h4>
<p className="text-zinc-600 text-[10px] leading-relaxed font-mono group-hover:text-zinc-400 transition-colors">
{feature.description}
</p>
</div>
</div>
))}
</div>
</div>
</section>
);
}
+41
View File
@@ -0,0 +1,41 @@
import React from 'react';
const GITHUB_ICON = (
<svg className="w-5 h-5" fill="currentColor" viewBox="0 0 24 24">
<path fillRule="evenodd" d="M12 2C6.477 2 2 6.484 2 12.017c0 4.425 2.865 8.18 6.839 9.504.5.092.682-.217.682-.483 0-.237-.008-.868-.013-1.703-2.782.605-3.369-1.343-3.369-1.343-.454-1.158-1.11-1.466-1.11-1.466-.908-.62.069-.608.069-.608 1.003.07 1.531 1.032 1.531 1.032.892 1.53 2.341 1.088 2.91.832.092-.647.35-1.088.636-1.338-2.22-.253-4.555-1.113-4.555-4.951 0-1.093.39-1.988 1.029-2.688-.103-.253-.446-1.272.098-2.65 0 0 .84-.27 2.75 1.026A9.564 9.564 0 0112 6.844c.85.004 1.705.115 2.504.337 1.909-1.296 2.747-1.027 2.747-1.027.546 1.379.202 2.398.1 2.651.64.7 1.028 1.595 1.028 2.688 0 3.848-2.339 4.695-4.566 4.943.359.309.678.92.678 1.855 0 1.338-.012 2.419-.012 2.747 0 .268.18.58.688.482A10.019 10.019 0 0022 12.017C22 6.484 17.522 2 12 2z" clipRule="evenodd" />
</svg>
);
export function Footer(): React.ReactElement {
const currentYear = new Date().getFullYear();
return (
<footer className="border-t border-border py-6 bg-black">
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8 flex flex-col sm:flex-row justify-between items-center gap-3">
<div className="flex flex-col sm:flex-row items-center gap-2 sm:gap-4 text-center sm:text-left">
<p className="text-zinc-500 text-xs font-mono">
&copy; {currentYear} SKILLKIT
</p>
<span className="hidden sm:inline text-zinc-700">•</span>
<a
href="https://agentskills.io"
target="_blank"
rel="noreferrer"
className="text-zinc-600 hover:text-zinc-400 text-xs font-mono transition-colors"
>
Agent Skills standard
</a>
</div>
<a
href="https://github.com/rohitg00/skillkit"
target="_blank"
rel="noopener noreferrer"
aria-label="SkillKit on GitHub"
className="text-zinc-500 hover:text-white transition-colors"
>
{GITHUB_ICON}
</a>
</div>
</footer>
);
}
+210
View File
@@ -0,0 +1,210 @@
import React, { useState, useEffect } from 'react';
import { Button } from './Button';
const ASCII_LOGO = `███████╗██╗ ██╗██╗██╗ ██╗ ██╗ ██╗██╗████████╗
██╔════╝██║ ██╔╝██║██║ ██║ ██║ ██╔╝██║╚══██╔══╝
███████╗█████╔╝ ██║██║ ██║ █████╔╝ ██║ ██║
╚════██║██╔═██╗ ██║██║ ██║ ██╔═██╗ ██║ ██║
███████║██║ ██╗██║███████╗███████╗██║ ██╗██║ ██║
╚══════╝╚═╝ ╚═╝╚═╝╚══════╝╚══════╝╚═╝ ╚═╝╚═╝ ╚═╝`;
interface TerminalLine {
type: 'cmd' | 'out';
text: string;
}
const TERMINAL_LINES: TerminalLine[] = [
{ type: 'cmd', text: 'skillkit init' },
{ type: 'out', text: '→ Next.js + TypeScript detected' },
{ type: 'cmd', text: 'skillkit install anthropics/skills' },
{ type: 'out', text: '→ Installed 3 skills' },
{ type: 'cmd', text: 'skillkit sync --all' },
{ type: 'out', text: ' .claude/skills/' },
{ type: 'out', text: ' .cursor/skills/' },
{ type: 'out', text: ' .windsurf/skills/' },
{ type: 'cmd', text: 'skillkit translate --to codex,copilot' },
{ type: 'out', text: '→ 2 formats generated' },
];
const FADE_ANIMATION_STYLES = `
@keyframes fade-in {
from { opacity: 0; transform: translateY(10px); }
to { opacity: 1; transform: translateY(0); }
}
.animate-fade-in {
animation: fade-in 0.6s ease-out forwards;
}
.animate-fade-in-delay {
animation: fade-in 0.6s ease-out 0.2s forwards;
opacity: 0;
}
`;
const CHECK_ICON = (
<svg className="w-4 h-4 text-white" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M5 13l4 4L19 7" />
</svg>
);
const COPY_ICON = (
<svg className="w-4 h-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M8 5H6a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2v-1M8 5a2 2 0 002 2h2a2 2 0 002-2M8 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4" />
</svg>
);
export function Hero(): React.ReactElement {
const [copied, setCopied] = useState(false);
const [visibleLines, setVisibleLines] = useState(0);
const [typingIndex, setTypingIndex] = useState(0);
const [currentText, setCurrentText] = useState('');
useEffect(() => {
if (visibleLines >= TERMINAL_LINES.length) {
const resetTimer = setTimeout(() => {
setVisibleLines(0);
setTypingIndex(0);
setCurrentText('');
}, 3000);
return () => clearTimeout(resetTimer);
}
const line = TERMINAL_LINES[visibleLines];
if (line.type === 'cmd') {
if (typingIndex < line.text.length) {
const timer = setTimeout(() => {
setCurrentText(line.text.slice(0, typingIndex + 1));
setTypingIndex(typingIndex + 1);
}, 40);
return () => clearTimeout(timer);
}
const timer = setTimeout(() => {
setVisibleLines(visibleLines + 1);
setTypingIndex(0);
setCurrentText('');
}, 200);
return () => clearTimeout(timer);
}
const timer = setTimeout(() => {
setVisibleLines(visibleLines + 1);
}, 150);
return () => clearTimeout(timer);
}, [visibleLines, typingIndex]);
async function copyInstall(): Promise<void> {
try {
await navigator.clipboard.writeText('npx skillkit@latest');
setCopied(true);
setTimeout(() => setCopied(false), 2000);
} catch {
// Clipboard API failed, silently ignore
}
}
function openGitHub(): void {
window.open('https://github.com/rohitg00/skillkit', '_blank', 'noopener,noreferrer');
}
const isTyping = visibleLines < TERMINAL_LINES.length && TERMINAL_LINES[visibleLines].type === 'cmd';
const isComplete = visibleLines >= TERMINAL_LINES.length;
return (
<div className="relative border-b border-zinc-800 overflow-hidden">
<div className="absolute inset-0 bg-gradient-to-b from-zinc-900/50 to-transparent pointer-events-none"></div>
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8 pt-8 pb-10 relative">
<div className="hidden lg:block mb-6 overflow-hidden">
<pre className="text-zinc-800 text-[8px] leading-none font-mono select-none animate-pulse">
{ASCII_LOGO}
</pre>
</div>
<div className="grid grid-cols-1 lg:grid-cols-2 gap-6 lg:gap-8 items-start">
<div className="animate-fade-in">
<div className="inline-flex items-center space-x-2 border border-zinc-800 bg-zinc-900/50 px-2 py-0.5 mb-3 backdrop-blur-sm">
<span className="flex h-1.5 w-1.5 bg-white rounded-full"></span>
<span className="text-xs font-mono text-zinc-400">v1.7.1</span>
</div>
<h1 className="text-2xl sm:text-3xl lg:text-4xl font-bold tracking-tight text-white mb-3 font-mono">
Universal Skills for<br />
<span className="text-zinc-500">AI Coding Agents</span>
</h1>
<p className="text-sm text-zinc-400 mb-5 max-w-lg font-mono leading-relaxed">
Portable, reusable skills that work across Claude Code, Cursor, Codex,
Windsurf, GitHub Copilot, and 12 more agents.
</p>
<div className="flex flex-wrap items-center gap-3 mb-4">
<button
onClick={copyInstall}
className="inline-flex items-center bg-black border border-zinc-700 px-3 py-2 hover:border-zinc-500 transition-colors"
>
<span className="text-zinc-500 mr-2 select-none">$</span>
<span className="font-mono text-zinc-100 text-sm">npx skillkit@latest</span>
<span className="ml-2 text-zinc-500 hover:text-white transition-colors flex items-center gap-1">
{copied ? (
<>
{CHECK_ICON}
<span className="text-xs text-green-400">Copied!</span>
</>
) : (
COPY_ICON
)}
</span>
</button>
<Button variant="outline" onClick={openGitHub}>
GITHUB
</Button>
</div>
</div>
<div className="hidden lg:block relative animate-fade-in-delay w-full">
<div className="absolute -inset-1 bg-gradient-to-r from-zinc-800 via-zinc-700 to-zinc-800 rounded-lg opacity-20 blur-lg"></div>
<div className="relative border border-zinc-800 bg-black rounded-lg overflow-hidden">
<div className="flex items-center gap-1.5 px-3 py-2 border-b border-zinc-800 bg-zinc-900/50">
<div className="w-2.5 h-2.5 rounded-full bg-zinc-700"></div>
<div className="w-2.5 h-2.5 rounded-full bg-zinc-700"></div>
<div className="w-2.5 h-2.5 rounded-full bg-zinc-700"></div>
<span className="ml-2 text-zinc-500 text-xs font-mono">skillkit</span>
</div>
<div className="p-4 font-mono text-xs min-h-[200px] max-h-[280px]">
{TERMINAL_LINES.slice(0, visibleLines).map((line, index) => (
<div key={index} className="mb-1">
{line.type === 'cmd' ? (
<div className="flex items-center">
<span className="text-zinc-600 mr-2">$</span>
<span className="text-zinc-100">{line.text}</span>
</div>
) : (
<div className="pl-4 text-zinc-500">
<span className="text-zinc-400">{line.text.slice(0, 1)}</span>
{line.text.slice(1)}
</div>
)}
</div>
))}
{isTyping && (
<div className="flex items-center">
<span className="text-zinc-600 mr-2">$</span>
<span className="text-zinc-100">{currentText}</span>
<span className="w-2 h-4 bg-zinc-400 ml-0.5 animate-pulse"></span>
</div>
)}
{isComplete && (
<div className="flex items-center mt-1">
<span className="text-zinc-600 mr-2">$</span>
<span className="w-2 h-4 bg-zinc-600 animate-pulse"></span>
</div>
)}
</div>
</div>
</div>
</div>
</div>
<style>{FADE_ANIMATION_STYLES}</style>
</div>
);
}
+650
View File
@@ -0,0 +1,650 @@
import React, { useState, useRef, useEffect } from 'react';
import { Button } from './Button';
import { Card } from './Card';
import { generateAgentSkill } from '../services/geminiService';
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 (
<span className={`text-xs px-2 py-0.5 border font-mono uppercase ${colorClass}`}>
{priority}
</span>
);
}
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<string, CachedSkill>;
}
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>(LoadingState.IDLE);
const [viewMode, setViewMode] = useState<ViewMode>('search');
const [marketplaceResults, setMarketplaceResults] = useState<IndexedSkill[]>([]);
const [selectedSkill, setSelectedSkill] = useState<IndexedSkill | null>(null);
const [skillContent, setSkillContent] = useState<string | null>(null);
const [generatedSkill, setGeneratedSkill] = useState<AgentSkill | null>(null);
const [isFromCache, setIsFromCache] = useState(false);
const [activeTab, setActiveTab] = useState<'principles' | 'patterns' | 'antipatterns'>('principles');
const [error, setError] = useState<string | null>(null);
const inputRef = useRef<HTMLInputElement>(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);
}
async function handleViewSkill(skill: IndexedSkill): Promise<void> {
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<void> {
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);
try {
const result = await generateAgentSkill(input);
setGeneratedSkill(result);
setCachedSkill(input, result); // Cache the result
setViewMode('generated');
setStatus(LoadingState.SUCCESS);
} catch {
setError("Failed to generate skill. Please try again.");
setStatus(LoadingState.ERROR);
}
}
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
<details>
<summary>Click to expand</summary>
\`\`\`markdown
${skillContent.slice(0, 4000)}${skillContent.length > 4000 ? '\n...(truncated)' : ''}
\`\`\`
</details>
### 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 (
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8 py-8">
<div className="mb-6">
<h2 className="text-xl font-bold text-white mb-1 font-sans">Skill Finder</h2>
<p className="text-zinc-400 font-mono text-xs">
Search the marketplace or generate new skills with AI.
</p>
</div>
<form onSubmit={handleSearch} className="mb-6">
<div className="flex flex-col sm:flex-row gap-3">
<input
ref={inputRef}
type="text"
value={input}
onChange={(e) => 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}
/>
<Button type="submit" isLoading={status === LoadingState.LOADING} className="sm:w-auto w-full">
SEARCH
</Button>
</div>
{error && <p className="mt-2 text-red-400 font-mono text-xs">{error}</p>}
</form>
{viewMode !== 'search' && status !== LoadingState.LOADING && (
<button
onClick={handleBack}
className="mb-6 text-zinc-400 hover:text-white font-mono text-sm flex items-center gap-2 transition-colors"
>
<svg xmlns="http://www.w3.org/2000/svg" className="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M15 19l-7-7 7-7" />
</svg>
Back
</button>
)}
{viewMode === 'marketplace' && status === LoadingState.SUCCESS && (
<div className="animate-fade-in-up">
<div className="flex items-center justify-between mb-6">
<h3 className="text-lg font-mono text-zinc-300">
Found {marketplaceResults.length} skill{marketplaceResults.length !== 1 ? 's' : ''} in marketplace
</h3>
</div>
<div className="space-y-3 mb-8">
{marketplaceResults.map((skill) => (
<Card
key={skill.id}
className="hover:border-zinc-500 cursor-pointer transition-all"
onClick={() => handleViewSkill(skill)}
>
<div className="flex items-start justify-between">
<div className="flex-1">
<h4 className="text-lg font-semibold text-white mb-1">{skill.name}</h4>
<p className="text-zinc-400 text-sm mb-2">{skill.description || 'No description'}</p>
<div className="flex items-center gap-2 text-xs text-zinc-500 font-mono">
<span>{skill.source}</span>
</div>
</div>
<svg xmlns="http://www.w3.org/2000/svg" className="h-5 w-5 text-zinc-600" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 5l7 7-7 7" />
</svg>
</div>
{skill.tags.length > 0 && (
<div className="flex flex-wrap gap-1 mt-3">
{skill.tags.slice(0, 5).map((tag, idx) => (
<span key={idx} className="text-xs bg-zinc-900 text-zinc-500 px-2 py-0.5 border border-zinc-800">
{tag}
</span>
))}
</div>
)}
</Card>
))}
</div>
<div className="border-t border-zinc-800 pt-6">
<p className="text-zinc-500 font-mono text-sm mb-4">
Don't see what you need? Generate a custom skill with AI.
</p>
<Button onClick={handleGenerateWithAI} isLoading={status === LoadingState.LOADING}>
GENERATE WITH AI
</Button>
</div>
</div>
)}
{viewMode === 'search' && status === LoadingState.SUCCESS && marketplaceResults.length === 0 && input && (
<div className="animate-fade-in-up text-center py-4">
<div className="text-zinc-500 font-mono text-sm mb-4">
No skills found for "{input}" in the marketplace.
</div>
<Button onClick={handleGenerateWithAI}>
GENERATE WITH AI
</Button>
</div>
)}
{viewMode === 'content' && selectedSkill && (
<div className="animate-fade-in-up">
<div className="flex items-start justify-between mb-6 border-b border-zinc-800 pb-6">
<div>
<h3 className="text-2xl font-bold text-white mb-2">{selectedSkill.name}</h3>
<p className="text-zinc-400 font-mono text-sm mb-2">{selectedSkill.description}</p>
<div className="flex items-center gap-2 text-xs text-zinc-500 font-mono">
<span>{selectedSkill.source}</span>
{selectedSkill.sourceUrl && (
<>
<span>•</span>
<a href={selectedSkill.sourceUrl} target="_blank" rel="noreferrer" className="hover:text-white">
View on GitHub
</a>
</>
)}
</div>
</div>
{skillContent && (
<button
onClick={downloadSkillMd}
className="flex items-center gap-2 bg-white text-black px-4 py-2 font-mono text-sm hover:bg-zinc-200 transition-colors shrink-0 ml-4"
>
<svg xmlns="http://www.w3.org/2000/svg" className="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M4 16v1a3 3 0 003 3h10a3 3 0 003-3v-1m-4-4l-4 4m0 0l-4-4m4 4V4" />
</svg>
DOWNLOAD
</button>
)}
</div>
{status === LoadingState.LOADING ? (
<div className="text-zinc-500 font-mono text-sm">Loading content...</div>
) : skillContent ? (
<pre className="bg-zinc-950 border border-zinc-800 p-6 overflow-x-auto text-sm max-h-[600px] overflow-y-auto">
<code className="text-zinc-300 font-mono whitespace-pre-wrap">{skillContent}</code>
</pre>
) : (
<div className="bg-zinc-950 border border-zinc-800 p-6">
<p className="text-zinc-400 font-mono text-sm mb-4">
Skill content not available for direct preview.
</p>
<a
href={selectedSkill.sourceUrl}
target="_blank"
rel="noreferrer"
className="inline-flex items-center gap-2 bg-zinc-800 text-white px-4 py-2 font-mono text-sm hover:bg-zinc-700 transition-colors"
>
View on GitHub
<svg xmlns="http://www.w3.org/2000/svg" className="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M10 6H6a2 2 0 00-2 2v10a2 2 0 002 2h10a2 2 0 002-2v-4M14 4h6m0 0v6m0-6L10 14" />
</svg>
</a>
</div>
)}
<div className="mt-6 pt-6 border-t border-zinc-800">
<p className="text-zinc-500 font-mono text-sm mb-3">Install with SkillKit:</p>
<pre className="bg-zinc-950 border border-zinc-800 p-4 text-sm overflow-x-auto">
<code className="text-zinc-300 font-mono text-xs sm:text-sm whitespace-nowrap">
npx skillkit install {selectedSkill.id.split('/').slice(0, 2).join('/')}
</code>
</pre>
</div>
</div>
)}
{viewMode === 'generated' && generatedSkill && (
<div className="animate-fade-in-up">
<div className="flex items-start justify-between mb-8 border-b border-zinc-800 pb-6">
<div className="flex-1">
<div className="flex flex-wrap items-center gap-2 mb-2">
<h3 className="text-xl sm:text-2xl font-bold text-white">{generatedSkill.title}</h3>
<span className="text-xs font-mono text-zinc-500 bg-zinc-900 px-2 py-1 border border-zinc-800">
v{generatedSkill.version}
</span>
<span className="text-xs font-mono text-purple-400 bg-purple-900/30 px-2 py-1 border border-purple-800/50">
AI Generated
</span>
{isFromCache && (
<span className="text-xs font-mono text-green-400 bg-green-900/30 px-2 py-1 border border-green-800/50">
Cached
</span>
)}
</div>
<p className="text-zinc-400 font-mono text-sm mb-4">{generatedSkill.description}</p>
<div className="flex flex-wrap gap-2">
{generatedSkill.tags.map((tag, idx) => (
<span key={idx} className="text-xs bg-zinc-900 text-zinc-400 px-2 py-1 border border-zinc-800">
{tag}
</span>
))}
</div>
</div>
<div className="flex flex-col sm:flex-row gap-2 shrink-0 ml-4">
<button
onClick={downloadGeneratedSkillMd}
className="flex items-center justify-center gap-2 bg-white text-black px-4 py-2 font-mono text-sm hover:bg-zinc-200 transition-colors"
>
<svg xmlns="http://www.w3.org/2000/svg" className="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M4 16v1a3 3 0 003 3h10a3 3 0 003-3v-1m-4-4l-4 4m0 0l-4-4m4 4V4" />
</svg>
DOWNLOAD
</button>
<button
onClick={submitToMarketplace}
className="flex items-center justify-center gap-2 bg-purple-600 text-white px-4 py-2 font-mono text-sm hover:bg-purple-500 transition-colors"
>
<svg xmlns="http://www.w3.org/2000/svg" className="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M7 16a4 4 0 01-.88-7.903A5 5 0 1115.9 6L16 6a5 5 0 011 9.9M15 13l-3-3m0 0l-3 3m3-3v12" />
</svg>
SUBMIT
</button>
</div>
</div>
<Card className="mb-6">
<h4 className="text-sm font-mono text-zinc-500 uppercase tracking-wider mb-2">When to Apply</h4>
<p className="text-zinc-300">{generatedSkill.applicability}</p>
{generatedSkill.filePatterns && generatedSkill.filePatterns.length > 0 && (
<div className="mt-3 flex flex-wrap gap-2">
{generatedSkill.filePatterns.map((pattern, idx) => (
<code key={idx} className="text-xs bg-zinc-900 text-zinc-300 px-2 py-1 border border-zinc-800">
{pattern}
</code>
))}
</div>
)}
</Card>
<div className="flex border-b border-zinc-800 mb-6">
{(['principles', 'patterns', 'antipatterns'] as const).map((tab) => (
<button
key={tab}
onClick={() => setActiveTab(tab)}
className={`px-6 py-3 font-mono text-sm uppercase tracking-wider transition-colors ${
activeTab === tab
? 'text-white border-b-2 border-white -mb-px'
: 'text-zinc-500 hover:text-zinc-300'
}`}
>
{tab === 'antipatterns' ? 'Anti-Patterns' : tab}
<span className="ml-2 text-xs text-zinc-600">
({tab === 'principles' ? generatedSkill.principles.length : tab === 'patterns' ? generatedSkill.patterns.length : generatedSkill.antiPatterns.length})
</span>
</button>
))}
</div>
<div className="space-y-4">
{activeTab === 'principles' && generatedSkill.principles.map((principle, idx) => (
<Card key={idx} className="hover:border-zinc-600 transition-colors">
<div className="flex items-start justify-between gap-4 mb-2">
<h4 className="text-lg font-semibold text-white">{principle.title}</h4>
<PriorityBadge priority={principle.priority} />
</div>
<p className="text-zinc-400 leading-relaxed">{principle.description}</p>
</Card>
))}
{activeTab === 'patterns' && generatedSkill.patterns.map((pattern, idx) => (
<Card key={idx} className="hover:border-zinc-600 transition-colors">
<h4 className="text-lg font-semibold text-white mb-2">{pattern.name}</h4>
<p className="text-zinc-400 mb-4">{pattern.description}</p>
<pre className="bg-zinc-950 border border-zinc-800 p-4 overflow-x-auto text-sm">
<code className="text-zinc-300 font-mono">{pattern.example}</code>
</pre>
</Card>
))}
{activeTab === 'antipatterns' && generatedSkill.antiPatterns.map((ap, idx) => (
<Card key={idx} className="hover:border-zinc-600 transition-colors border-red-900/30">
<h4 className="text-lg font-semibold text-white mb-2">{ap.name}</h4>
<p className="text-zinc-400 mb-4">{ap.description}</p>
{ap.badExample && (
<div className="mb-4">
<div className="text-xs font-mono text-red-400 mb-1 uppercase">Bad</div>
<pre className="bg-red-950/20 border border-red-900/30 p-4 overflow-x-auto text-sm">
<code className="text-red-300 font-mono">{ap.badExample}</code>
</pre>
</div>
)}
{ap.goodExample && (
<div>
<div className="text-xs font-mono text-zinc-300 mb-1 uppercase">Good</div>
<pre className="bg-zinc-900/50 border border-zinc-700 p-4 overflow-x-auto text-sm">
<code className="text-zinc-200 font-mono">{ap.goodExample}</code>
</pre>
</div>
)}
</Card>
))}
</div>
{generatedSkill.references && generatedSkill.references.length > 0 && (
<div className="mt-8 pt-6 border-t border-zinc-800">
<h4 className="text-sm font-mono text-zinc-500 uppercase tracking-wider mb-3">References</h4>
<ul className="space-y-1">
{generatedSkill.references.map((ref, idx) => (
<li key={idx}>
<a
href={ref}
target="_blank"
rel="noreferrer"
className="text-zinc-400 hover:text-white font-mono text-sm transition-colors"
>
{ref}
</a>
</li>
))}
</ul>
</div>
)}
</div>
)}
</div>
);
}
@@ -0,0 +1,551 @@
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 = (
<svg className="w-5 h-5" fill="currentColor" viewBox="0 0 24 24">
<path fillRule="evenodd" d="M12 2C6.477 2 2 6.484 2 12.017c0 4.425 2.865 8.18 6.839 9.504.5.092.682-.217.682-.483 0-.237-.008-.868-.013-1.703-2.782.605-3.369-1.343-3.369-1.343-.454-1.158-1.11-1.466-1.11-1.466-.908-.62.069-.608.069-.608 1.003.07 1.531 1.032 1.531 1.032.892 1.53 2.341 1.088 2.91.832.092-.647.35-1.088.636-1.338-2.22-.253-4.555-1.113-4.555-4.951 0-1.093.39-1.988 1.029-2.688-.103-.253-.446-1.272.098-2.65 0 0 .84-.27 2.75 1.026A9.564 9.564 0 0112 6.844c.85.004 1.705.115 2.504.337 1.909-1.296 2.747-1.027 2.747-1.027.546 1.379.202 2.398.1 2.651.64.7 1.028 1.595 1.028 2.688 0 3.848-2.339 4.695-4.566 4.943.359.309.678.92.678 1.855 0 1.338-.012 2.419-.012 2.747 0 .268.18.58.688.482A10.019 10.019 0 0022 12.017C22 6.484 17.522 2 12 2z" clipRule="evenodd" />
</svg>
);
export function SkillSubmitForm(): React.ReactElement {
const [mode, setMode] = useState<Mode>('import');
const [form, setForm] = useState<SkillFormData>(INITIAL_FORM);
const [isDragging, setIsDragging] = useState(false);
const [fileName, setFileName] = useState<string | null>(null);
const [githubUrl, setGithubUrl] = useState('');
const [isDetecting, setIsDetecting] = useState(false);
const [detectError, setDetectError] = useState<string | null>(null);
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;
});
}
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<void> {
if (!githubUrl) return;
setIsDetecting(true);
setDetectError(null);
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);
}
}
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<HTMLInputElement>): 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
<details>
<summary>Click to expand</summary>
\`\`\`markdown
${form.skillContent.slice(0, 4000)}${form.skillContent.length > 4000 ? '\n...(truncated)' : ''}
\`\`\`
</details>
### 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');
}
}
return (
<div className="space-y-6">
<div className="flex border-b border-zinc-800">
<button
onClick={() => setMode('import')}
className={`px-6 py-3 font-mono text-sm transition-colors ${
mode === 'import'
? 'text-white border-b-2 border-white -mb-px'
: 'text-zinc-500 hover:text-zinc-300'
}`}
>
Import from GitHub
</button>
<button
onClick={() => setMode('upload')}
className={`px-6 py-3 font-mono text-sm transition-colors ${
mode === 'upload'
? 'text-white border-b-2 border-white -mb-px'
: 'text-zinc-500 hover:text-zinc-300'
}`}
>
Upload File
</button>
</div>
<div className="grid grid-cols-1 lg:grid-cols-2 gap-6">
<div className="space-y-6">
{mode === 'import' && (
<Card>
<div className="flex items-center justify-between mb-1">
<label className="text-sm text-zinc-400">GitHub URL</label>
<span className="text-xs text-zinc-600">Repo, tree path, or blob</span>
</div>
<div className="flex gap-3 mt-2">
<input
type="text"
value={githubUrl}
onChange={(e) => 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"
/>
<button
onClick={handleDetect}
disabled={isDetecting || !githubUrl}
className={`px-5 py-2.5 font-mono text-sm transition-colors ${
isDetecting || !githubUrl
? 'bg-zinc-800 text-zinc-600 cursor-not-allowed'
: 'bg-white text-black hover:bg-zinc-200'
}`}
>
{isDetecting ? 'Detecting...' : 'Detect'}
</button>
</div>
{detectError && (
<p className="text-red-400 text-xs mt-2 font-mono">{detectError}</p>
)}
{isImported && (
<p className="text-zinc-300 text-xs mt-2 font-mono flex items-center gap-1">
<svg className="w-3 h-3" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M5 13l4 4L19 7" />
</svg>
Repository detected - {form.repoOwner}/{form.repoName}
</p>
)}
<p className="text-zinc-600 text-xs mt-3">
Public repos only. We link to the original - owner retains all rights.
</p>
</Card>
)}
{mode === 'upload' && (
<Card
className={`transition-colors ${isDragging ? 'border-white bg-zinc-900' : ''}`}
onDragOver={handleDragOver}
onDragLeave={handleDragLeave}
onDrop={handleDrop}
>
<div className="text-center py-6">
<div className="mb-3">
<svg className="w-8 h-8 mx-auto text-zinc-600" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M7 16a4 4 0 01-.88-7.903A5 5 0 1115.9 6L16 6a5 5 0 011 9.9M15 13l-3-3m0 0l-3 3m3-3v12" />
</svg>
</div>
<p className="text-zinc-400 text-sm mb-1">
{fileName ? (
<span className="text-white">{fileName}</span>
) : (
'Drop SKILL.md here'
)}
</p>
<p className="text-zinc-600 text-xs mb-3">or</p>
<label className="inline-block cursor-pointer">
<span className="bg-zinc-800 hover:bg-zinc-700 text-white px-4 py-2 text-sm font-mono transition-colors">
Choose file
</span>
<input
type="file"
accept=".md"
onChange={handleFileSelect}
className="hidden"
/>
</label>
</div>
</Card>
)}
<Card>
<div className="space-y-4">
<div className="grid grid-cols-2 gap-4">
<div>
<label className="block text-sm text-zinc-400 mb-1.5">Slug</label>
<input
type="text"
value={form.slug}
onChange={(e) => 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"
/>
</div>
<div>
<label className="block text-sm text-zinc-400 mb-1.5">Display name</label>
<input
type="text"
value={form.displayName}
onChange={(e) => 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"
/>
</div>
</div>
<div className="grid grid-cols-2 gap-4">
<div>
<label className="block text-sm text-zinc-400 mb-1.5">Version</label>
<input
type="text"
value={form.version}
onChange={(e) => 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"
/>
</div>
<div>
<label className="block text-sm text-zinc-400 mb-1.5">Tags</label>
<input
type="text"
value={form.tags}
onChange={(e) => 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"
/>
</div>
</div>
<div className="flex flex-wrap gap-1.5">
{TAG_SUGGESTIONS.map((tag) => (
<button
key={tag}
type="button"
onClick={() => addTag(tag)}
className="text-xs text-zinc-500 hover:text-zinc-300 hover:bg-zinc-800 px-2 py-0.5 border border-zinc-800 transition-colors"
>
+{tag}
</button>
))}
</div>
</div>
</Card>
</div>
<div className="space-y-6">
<Card>
<h4 className="text-sm text-zinc-400 mb-4">Preview</h4>
<div className="bg-zinc-950 border border-zinc-800 p-4">
<div className="flex items-start justify-between mb-3">
<div>
<h5 className="text-white font-semibold">
{form.displayName || 'Skill Name'}
</h5>
<p className="text-zinc-500 text-sm mt-1">
{form.description || 'No description'}
</p>
</div>
<span className="text-xs font-mono text-zinc-600 bg-zinc-900 px-2 py-1">
v{form.version}
</span>
</div>
{(form.repoOwner || form.authorGithub) && (
<div className="flex items-center gap-2 text-xs text-zinc-600 font-mono mb-3">
{form.repoOwner && form.repoName && <span>{form.repoOwner}/{form.repoName}</span>}
{form.authorGithub && (
<>
{form.repoOwner && <span>•</span>}
<span>@{form.authorGithub}</span>
</>
)}
</div>
)}
{tagsArray.length > 0 && (
<div className="flex flex-wrap gap-1.5">
{tagsArray.map((tag, i) => (
<span key={i} className="text-xs bg-zinc-900 text-zinc-500 px-2 py-0.5 border border-zinc-800">
{tag}
</span>
))}
</div>
)}
</div>
</Card>
{isImported ? (
<Card className="border-blue-900/50">
<div className="flex items-center gap-3 mb-3">
<div className="w-8 h-8 bg-blue-900/30 border border-blue-800 flex items-center justify-center">
<svg className="w-4 h-4 text-blue-400" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M13.828 10.172a4 4 0 00-5.656 0l-4 4a4 4 0 105.656 5.656l1.102-1.101m-.758-4.899a4 4 0 005.656 0l4-4a4 4 0 00-5.656-5.656l-1.1 1.1" />
</svg>
</div>
<div>
<h4 className="text-sm text-white font-medium">Linked Repository</h4>
<p className="text-xs text-zinc-500">Skills hosted by @{form.repoOwner}</p>
</div>
</div>
<a
href={`https://github.com/${form.repoOwner}/${form.repoName}`}
target="_blank"
rel="noopener noreferrer"
className="text-sm text-blue-400 hover:text-blue-300 font-mono flex items-center gap-2"
>
github.com/{form.repoOwner}/{form.repoName}
<svg className="w-3 h-3" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M10 6H6a2 2 0 00-2 2v10a2 2 0 002 2h10a2 2 0 002-2v-4M14 4h6m0 0v6m0-6L10 14" />
</svg>
</a>
</Card>
) : form.skillContent && !form.skillContent.startsWith('[Linked') ? (
<Card>
<h4 className="text-sm text-zinc-400 mb-3">SKILL.md</h4>
<pre className="bg-zinc-950 border border-zinc-800 p-3 text-xs font-mono text-zinc-400 max-h-48 overflow-auto">
{form.skillContent.slice(0, 1000)}
{form.skillContent.length > 1000 && '\n...'}
</pre>
</Card>
) : null}
{errors.length > 0 && (
<div className="space-y-1 text-xs font-mono text-yellow-500">
{errors.map((error, i) => (
<div key={i} className="flex items-center gap-1">
<span className="text-yellow-600">•</span> {error}
</div>
))}
</div>
)}
<button
type="button"
onClick={handleSubmitClick}
disabled={!isValid}
className={`flex items-center justify-center gap-3 w-full py-4 font-mono text-sm transition-all ${
isValid
? 'bg-white text-black hover:bg-zinc-200'
: 'bg-zinc-800 text-zinc-600 cursor-not-allowed'
}`}
>
{GITHUB_ICON}
{isImported ? 'Import to marketplace' : 'Publish skill'}
</button>
<p className="text-xs text-zinc-600 text-center font-mono">
{isImported
? 'Links to original repo → Owner retains rights'
: 'Opens GitHub issue → We review → Added to marketplace'}
</p>
</div>
</div>
</div>
);
}
+56
View File
@@ -0,0 +1,56 @@
import React from 'react';
interface TerminalProps {
title?: string;
children: React.ReactNode;
className?: string;
}
interface CodeBlockProps {
code: string;
language?: string;
}
interface CommandProps {
cmd: string;
comment?: string;
}
export function Terminal({ title = 'bash', children, className = '' }: TerminalProps): React.ReactElement {
return (
<div className={`rounded-lg overflow-hidden border border-zinc-800 bg-[#09090b] shadow-2xl ${className}`}>
<div className="flex items-center justify-between px-4 py-2 border-b border-zinc-800 bg-zinc-900/50">
<div className="flex space-x-2">
<div className="w-3 h-3 rounded-full bg-zinc-700"></div>
<div className="w-3 h-3 rounded-full bg-zinc-700"></div>
<div className="w-3 h-3 rounded-full bg-zinc-700"></div>
</div>
<div className="text-xs text-zinc-500 font-mono">{title}</div>
<div className="w-10"></div>
</div>
<div className="p-4 font-mono text-sm overflow-x-auto">
{children}
</div>
</div>
);
}
export function CodeBlock({ code }: CodeBlockProps): React.ReactElement {
return (
<pre className="text-zinc-300 font-mono text-sm leading-relaxed whitespace-pre-wrap">
{code}
</pre>
);
}
export function Command({ cmd, comment }: CommandProps): React.ReactElement {
return (
<div className="mb-2">
<div className="flex text-zinc-100">
<span className="text-zinc-500 mr-2">$</span>
<span>{cmd}</span>
</div>
{comment && <div className="text-zinc-500 text-xs mt-1 ml-4"># {comment}</div>}
</div>
);
}
+99
View File
@@ -0,0 +1,99 @@
{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "SkillKit Marketplace",
"description": "Schema for SkillKit marketplace skills index",
"type": "object",
"required": ["version", "skills"],
"properties": {
"version": {
"type": "integer",
"description": "Schema version number"
},
"updatedAt": {
"type": "string",
"format": "date",
"description": "Last update date (YYYY-MM-DD)"
},
"skills": {
"type": "array",
"description": "List of skills in the marketplace",
"items": {
"$ref": "#/definitions/Skill"
}
}
},
"definitions": {
"Skill": {
"type": "object",
"required": ["id", "name", "source", "tags"],
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]+/[a-zA-Z0-9_.-]+/[a-zA-Z0-9_-]+$",
"description": "Unique identifier: owner/repo/skill-name"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Human-readable skill name"
},
"description": {
"type": "string",
"maxLength": 500,
"description": "Brief description of the skill"
},
"source": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]+/[a-zA-Z0-9_.-]+$",
"description": "GitHub repository: owner/repo"
},
"tags": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9-]+$"
},
"minItems": 1,
"maxItems": 10,
"description": "Tags for categorization (lowercase, hyphenated)"
},
"author": {
"type": "string",
"description": "Skill author name or GitHub username"
},
"version": {
"type": "string",
"pattern": "^\\d+\\.\\d+\\.\\d+$",
"description": "Semantic version (e.g., 1.0.0)"
},
"agents": {
"type": "array",
"items": {
"type": "string",
"enum": [
"claude-code",
"cursor",
"codex",
"gemini-cli",
"opencode",
"antigravity",
"amp",
"clawdbot",
"droid",
"github-copilot",
"goose",
"kilo",
"kiro-cli",
"roo",
"trae",
"windsurf",
"universal"
]
},
"description": "Compatible AI agents (omit for universal compatibility)"
}
}
}
}
}
+58
View File
@@ -0,0 +1,58 @@
// Single source of truth: marketplace/skills.json
import skillsData from '../../../marketplace/skills.json';
export interface IndexedSkill {
id: string;
name: string;
description: string;
source: string;
sourceUrl: string;
rawUrl: string;
tags: string[];
}
function buildSkillIndex(): IndexedSkill[] {
return skillsData.skills.map(skill => {
const sourceParts = skill.source?.split('/') || [];
const owner = sourceParts[0] || 'unknown';
const repo = sourceParts[1] || 'unknown';
const skillSlug = skill.id.split('/').pop() || skill.name.toLowerCase().replace(/\s+/g, '-');
return {
id: skill.id,
name: skill.name,
description: skill.description || '',
source: skill.source || '',
sourceUrl: owner !== 'unknown' ? `https://github.com/${skill.source}` : '',
rawUrl: owner !== 'unknown' && repo !== 'unknown'
? `https://raw.githubusercontent.com/${owner}/${repo}/main/skills/${skillSlug}/SKILL.md`
: '',
tags: skill.tags || [],
};
});
}
export const SKILLS_INDEX: IndexedSkill[] = buildSkillIndex();
export function searchSkills(query: string): IndexedSkill[] {
const q = query.toLowerCase().trim();
if (!q) return [];
return SKILLS_INDEX.filter(skill =>
skill.name.toLowerCase().includes(q) ||
skill.description.toLowerCase().includes(q) ||
skill.tags.some(tag => tag.toLowerCase().includes(q))
).slice(0, 20);
}
export function getSkillsByTag(tag: string): IndexedSkill[] {
return SKILLS_INDEX.filter(skill =>
skill.tags.some(t => t.toLowerCase() === tag.toLowerCase())
);
}
export function getAllTags(): string[] {
const tags = new Set<string>();
SKILLS_INDEX.forEach(skill => skill.tags.forEach(tag => tags.add(tag)));
return Array.from(tags).sort();
}
+118
View File
@@ -0,0 +1,118 @@
<!DOCTYPE html>
<html lang="en" class="dark">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>SkillKit - Universal Skills for AI Coding Agents</title>
<meta name="description" content="Portable, reusable skills that work across Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and 12 more AI coding agents.">
<!-- Open Graph -->
<meta property="og:type" content="website">
<meta property="og:url" content="https://skillkit.dev/">
<meta property="og:title" content="SkillKit - Universal Skills for AI Coding Agents">
<meta property="og:description" content="Portable, reusable skills that work across Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and 12 more AI coding agents.">
<meta property="og:image" content="/og-image.png">
<!-- Twitter -->
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="SkillKit - Universal Skills for AI Coding Agents">
<meta name="twitter:description" content="Portable, reusable skills that work across Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and 12 more AI coding agents.">
<meta name="twitter:image" content="/og-image.png">
<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
<link rel="icon" type="image/png" sizes="32x32" href="/favicon-32.png" />
<link rel="apple-touch-icon" href="/apple-touch-icon.png" />
<script src="https://cdn.tailwindcss.com"></script>
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
<script>
tailwind.config = {
darkMode: 'class',
theme: {
screens: {
'xs': '475px',
'sm': '640px',
'md': '768px',
'lg': '1024px',
'xl': '1280px',
'2xl': '1536px',
},
extend: {
fontFamily: {
sans: ['Inter', 'sans-serif'],
mono: ['JetBrains Mono', 'monospace'],
},
colors: {
background: '#000000',
surface: '#09090b',
border: '#27272a',
highlight: '#ffffff',
},
animation: {
'cursor-blink': 'blink 1s step-end infinite',
},
keyframes: {
blink: {
'0%, 100%': { opacity: '1' },
'50%': { opacity: '0' },
}
}
}
}
}
</script>
<style>
body {
background-color: #000000;
color: #e4e4e7;
font-family: 'Inter', sans-serif;
}
h1, h2, h3, h4, h5, h6, .font-mono {
font-family: 'JetBrains Mono', monospace;
}
::selection {
background-color: #ffffff;
color: #000000;
}
::-webkit-scrollbar {
width: 10px;
background: #000000;
}
::-webkit-scrollbar-thumb {
background: #27272a;
border: 1px solid #000000;
}
::-webkit-scrollbar-thumb:hover {
background: #3f3f46;
}
.terminal-scanline {
background: linear-gradient(to bottom, rgba(255,255,255,0), rgba(255,255,255,0) 50%, rgba(0,0,0,0.1) 50%, rgba(0,0,0,0.1));
background-size: 100% 4px;
position: absolute;
top: 0;
left: 0;
right: 0;
bottom: 0;
pointer-events: none;
z-index: 10;
opacity: 0.1;
}
</style>
<script type="importmap">
{
"imports": {
"react/": "https://esm.sh/react@^19.2.3/",
"react": "https://esm.sh/react@^19.2.3",
"@google/genai": "https://esm.sh/@google/genai@^1.38.0",
"react-dom/": "https://esm.sh/react-dom@^19.2.3/"
}
}
</script>
</head>
<body>
<div id="root"></div>
<script type="module" src="/index.tsx"></script>
</body>
</html>
+15
View File
@@ -0,0 +1,15 @@
import React from 'react';
import ReactDOM from 'react-dom/client';
import App from './App';
const rootElement = document.getElementById('root');
if (!rootElement) {
throw new Error("Could not find root element to mount to");
}
const root = ReactDOM.createRoot(rootElement);
root.render(
<React.StrictMode>
<App />
</React.StrictMode>
);
+5
View File
@@ -0,0 +1,5 @@
{
"name": "SkillKit",
"description": "Supercharge Every AI Coding Agent. Translate, manage, and sync skills across Claude, Cursor, Windsurf, and 17+ agents.",
"requestFramePermissions": []
}
+2709
View File
File diff suppressed because it is too large Load Diff
+22
View File
@@ -0,0 +1,22 @@
{
"name": "skillkit",
"private": true,
"version": "0.0.0",
"type": "module",
"scripts": {
"dev": "vite",
"build": "vite build",
"preview": "vite preview"
},
"dependencies": {
"react": "^19.2.3",
"@google/genai": "^1.38.0",
"react-dom": "^19.2.3"
},
"devDependencies": {
"@types/node": "^22.14.0",
"@vitejs/plugin-react": "^5.0.0",
"typescript": "~5.8.2",
"vite": "^6.2.0"
}
}
+23
View File
@@ -0,0 +1,23 @@
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>SkillKit</title>
<script type="text/javascript">
// Single Page Apps for GitHub Pages
// MIT License
// https://github.com/rafgraph/spa-github-pages
var pathSegmentsToKeep = 1;
var l = window.location;
l.replace(
l.protocol + '//' + l.hostname + (l.port ? ':' + l.port : '') +
l.pathname.split('/').slice(0, 1 + pathSegmentsToKeep).join('/') + '/?/' +
l.pathname.slice(1).split('/').slice(pathSegmentsToKeep).join('/').replace(/&/g, '~and~') +
(l.search ? '&' + l.search.slice(1).replace(/&/g, '~and~') : '') +
l.hash
);
</script>
</head>
<body>
</body>
</html>
Binary file not shown.

After

Width:  |  Height:  |  Size: 1.0 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 437 B

+4
View File
@@ -0,0 +1,4 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32">
<rect width="32" height="32" fill="#000000"/>
<rect x="8" y="8" width="16" height="16" fill="#ffffff"/>
</svg>

After

Width:  |  Height:  |  Size: 176 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 158 KiB

+124
View File
@@ -0,0 +1,124 @@
import { GoogleGenAI, Type, Schema } from "@google/genai";
import { AgentSkill } from "../types";
const ai = new GoogleGenAI({ apiKey: process.env.API_KEY });
const agentSkillSchema: Schema = {
type: Type.OBJECT,
properties: {
name: { type: Type.STRING, description: "Skill name in slug format (e.g., 'react-best-practices')" },
title: { type: Type.STRING, description: "Human readable title" },
description: { type: Type.STRING, description: "Brief description of what this skill teaches AI agents" },
version: { type: Type.STRING, description: "Semantic version (e.g., '1.0.0')" },
tags: {
type: Type.ARRAY,
items: { type: Type.STRING },
description: "Tags for categorization"
},
applicability: { type: Type.STRING, description: "When the AI agent should apply this skill (e.g., 'Apply when working with React components')" },
principles: {
type: Type.ARRAY,
items: {
type: Type.OBJECT,
properties: {
title: { type: Type.STRING },
description: { type: Type.STRING, description: "Detailed instruction for the AI agent" },
priority: { type: Type.STRING, description: "must, should, or may" }
},
required: ["title", "description", "priority"]
},
description: "Core principles and guidelines (5-8 items)"
},
patterns: {
type: Type.ARRAY,
items: {
type: Type.OBJECT,
properties: {
name: { type: Type.STRING },
description: { type: Type.STRING },
example: { type: Type.STRING, description: "Code example demonstrating the pattern" },
language: { type: Type.STRING, description: "Programming language for syntax highlighting" }
},
required: ["name", "description", "example"]
},
description: "Code patterns with examples (3-5 items)"
},
antiPatterns: {
type: Type.ARRAY,
items: {
type: Type.OBJECT,
properties: {
name: { type: Type.STRING },
description: { type: Type.STRING },
badExample: { type: Type.STRING, description: "Code showing what NOT to do" },
goodExample: { type: Type.STRING, description: "Code showing the correct approach" }
},
required: ["name", "description"]
},
description: "Anti-patterns to avoid (2-4 items)"
},
filePatterns: {
type: Type.ARRAY,
items: { type: Type.STRING },
description: "Glob patterns for files this skill applies to (e.g., '*.tsx', 'src/components/**')"
},
references: {
type: Type.ARRAY,
items: { type: Type.STRING },
description: "Links to official documentation or resources"
}
},
required: ["name", "title", "description", "version", "tags", "applicability", "principles", "patterns", "antiPatterns"]
};
export const generateAgentSkill = async (topic: string): Promise<AgentSkill> => {
const sanitizedTopic = topic?.trim().slice(0, 500) || '';
if (!sanitizedTopic) {
throw new Error("Topic is required");
}
try {
const response = await ai.models.generateContent({
model: "gemini-2.0-flash",
contents: `Create a comprehensive AI coding agent skill for: "${sanitizedTopic}"
This skill will be used by AI coding assistants (like Claude Code, Cursor, GitHub Copilot) to provide better code suggestions and follow best practices.
The skill should include:
1. Clear principles that tell the AI WHAT to do and WHEN
2. Code patterns with REAL, WORKING examples (not pseudocode)
3. Anti-patterns showing common mistakes and how to fix them
4. Specific file patterns where this skill applies
Make the instructions actionable and specific. The AI agent should be able to directly apply these guidelines when writing code.
Focus on practical, production-ready patterns used in modern development.`,
config: {
responseMimeType: "application/json",
responseSchema: agentSkillSchema,
systemInstruction: `You are an expert software architect creating AI agent skills.
Your skills are used by AI coding assistants to write better code.
Guidelines:
- Write instructions as commands to the AI (e.g., "Always use...", "Never...", "Prefer...")
- Include REAL code examples, not pseudocode
- Be specific and actionable
- Focus on modern best practices (2024+)
- Include edge cases and error handling patterns
- Make principles enforceable and testable`
}
});
if (!response.text) {
throw new Error("No response from Gemini.");
}
const data = JSON.parse(response.text) as AgentSkill;
return data;
} catch (error) {
console.error("Gemini API Error:", error);
throw error;
}
};
export const generateLearningPath: (topic: string) => Promise<AgentSkill> = generateAgentSkill;
+29
View File
@@ -0,0 +1,29 @@
{
"compilerOptions": {
"target": "ES2022",
"experimentalDecorators": true,
"useDefineForClassFields": false,
"module": "ESNext",
"lib": [
"ES2022",
"DOM",
"DOM.Iterable"
],
"skipLibCheck": true,
"types": [
"node"
],
"moduleResolution": "bundler",
"isolatedModules": true,
"moduleDetection": "force",
"allowJs": true,
"jsx": "react-jsx",
"paths": {
"@/*": [
"./*"
]
},
"allowImportingTsExtensions": true,
"noEmit": true
}
}
+57
View File
@@ -0,0 +1,57 @@
export interface LearningStep {
title: string;
description: string;
duration: string;
keyConcepts: string[];
}
export interface LearningPath {
skill: string;
description: string;
steps: LearningStep[];
}
export interface GenerateSkillResponse {
learningPath: LearningPath;
}
export enum LoadingState {
IDLE = 'IDLE',
LOADING = 'LOADING',
SUCCESS = 'SUCCESS',
ERROR = 'ERROR'
}
export interface AgentSkill {
name: string;
title: string;
description: string;
version: string;
tags: string[];
applicability: string;
principles: SkillPrinciple[];
patterns: SkillPattern[];
antiPatterns: SkillAntiPattern[];
filePatterns?: string[];
references?: string[];
}
export interface SkillPrinciple {
title: string;
description: string;
priority: 'must' | 'should' | 'may';
}
export interface SkillPattern {
name: string;
description: string;
example: string;
language?: string;
}
export interface SkillAntiPattern {
name: string;
description: string;
badExample?: string;
goodExample?: string;
}
+6
View File
@@ -0,0 +1,6 @@
{
"buildCommand": "npm run build",
"outputDirectory": "dist",
"installCommand": "npm install",
"framework": "vite"
}
+28
View File
@@ -0,0 +1,28 @@
import path from 'path';
import { defineConfig, loadEnv } from 'vite';
import react from '@vitejs/plugin-react';
export default defineConfig(({ mode }) => {
const env = loadEnv(mode, '.', '');
return {
base: '/',
server: {
port: 3000,
host: '0.0.0.0',
},
plugins: [react()],
define: {
'process.env.API_KEY': JSON.stringify(env.GEMINI_API_KEY),
'process.env.GEMINI_API_KEY': JSON.stringify(env.GEMINI_API_KEY)
},
resolve: {
alias: {
'@': path.resolve(__dirname, '.'),
}
},
build: {
outDir: 'dist',
emptyOutDir: true,
}
};
});
+94
View File
@@ -0,0 +1,94 @@
# Contributing Skills to SkillKit Marketplace
## How to Add Your Skill
1. Fork this repository
2. Add your skill to `marketplace/skills.json`
3. Submit a Pull Request
## Skill Format
```json
{
"id": "your-username/your-repo/skill-name",
"name": "Your Skill Name",
"description": "Brief description of what the skill does",
"source": "your-username/your-repo",
"tags": ["tag1", "tag2"]
}
```
## Field Reference
| Field | Required | Description |
|-------|----------|-------------|
| `id` | Yes | Unique identifier: `owner/repo/skill-name` |
| `name` | Yes | Human-readable name (max 100 chars) |
| `description` | No | Brief description (max 500 chars) |
| `source` | Yes | GitHub repository: `owner/repo` |
| `tags` | Yes | 1-10 lowercase tags for categorization |
| `author` | No | Your name or GitHub username |
| `version` | No | Semantic version (e.g., `1.0.0`) |
| `agents` | No | Compatible agents (omit for universal) |
## Skill Repository Structure
Your skill repository should contain a `SKILL.md` file:
```text
your-repo/
├── skills/
│ └── skill-name/
│ └── SKILL.md
└── README.md
```
## SKILL.md Format
```markdown
---
name: "skill-name"
description: "What this skill does"
version: "1.0.0"
tags: ["tag1", "tag2"]
globs: ["**/*.tsx", "**/*.ts"]
---
# Skill Title
Instructions for AI agents...
## Principles
- Principle 1
- Principle 2
## Patterns
### Pattern Name
Description and examples...
```
## Guidelines
- **Be specific**: Skills should focus on one topic
- **Include examples**: Code examples help AI agents understand patterns
- **Test your skill**: Verify it works with at least one agent
- **Keep it updated**: Maintain compatibility with latest agent versions
## Supported Agents
Skills can target specific agents or be universal:
- `claude-code` - Anthropic Claude Code
- `cursor` - Cursor IDE
- `codex` - OpenAI Codex CLI
- `gemini-cli` - Google Gemini CLI
- `windsurf` - Codeium Windsurf
- `github-copilot` - GitHub Copilot
- `universal` - All agents
## Questions?
Open an issue or join our Discord community.
+99
View File
@@ -0,0 +1,99 @@
{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "SkillKit Marketplace",
"description": "Schema for SkillKit marketplace skills index",
"type": "object",
"required": ["version", "skills"],
"properties": {
"version": {
"type": "integer",
"description": "Schema version number"
},
"updatedAt": {
"type": "string",
"format": "date",
"description": "Last update date (YYYY-MM-DD)"
},
"skills": {
"type": "array",
"description": "List of skills in the marketplace",
"items": {
"$ref": "#/definitions/Skill"
}
}
},
"definitions": {
"Skill": {
"type": "object",
"required": ["id", "name", "source", "tags"],
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]+/[a-zA-Z0-9_.-]+/[a-zA-Z0-9_-]+$",
"description": "Unique identifier: owner/repo/skill-name"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Human-readable skill name"
},
"description": {
"type": "string",
"maxLength": 500,
"description": "Brief description of the skill"
},
"source": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]+/[a-zA-Z0-9_.-]+$",
"description": "GitHub repository: owner/repo"
},
"tags": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9-]+$"
},
"minItems": 1,
"maxItems": 10,
"description": "Tags for categorization (lowercase, hyphenated)"
},
"author": {
"type": "string",
"description": "Skill author name or GitHub username"
},
"version": {
"type": "string",
"pattern": "^\\d+\\.\\d+\\.\\d+$",
"description": "Semantic version (e.g., 1.0.0)"
},
"agents": {
"type": "array",
"items": {
"type": "string",
"enum": [
"claude-code",
"cursor",
"codex",
"gemini-cli",
"opencode",
"antigravity",
"amp",
"clawdbot",
"droid",
"github-copilot",
"goose",
"kilo",
"kiro-cli",
"roo",
"trae",
"windsurf",
"universal"
]
},
"description": "Compatible AI agents (omit for universal compatibility)"
}
}
}
}
}
+125561
View File
File diff suppressed because it is too large Load Diff
+49
View File
@@ -0,0 +1,49 @@
{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "SkillKit Sources",
"description": "Schema for curated skill repository sources",
"type": "object",
"required": ["version", "sources"],
"properties": {
"$schema": {
"type": "string",
"description": "Schema reference"
},
"version": {
"type": "integer",
"description": "Schema version"
},
"updatedAt": {
"type": "string",
"format": "date",
"description": "Last update date"
},
"description": {
"type": "string",
"description": "Description of this file"
},
"sources": {
"type": "array",
"description": "List of curated skill sources",
"items": {
"type": "object",
"required": ["source", "name"],
"properties": {
"source": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]+/[a-zA-Z0-9_-]+$",
"description": "GitHub owner/repo format"
},
"name": {
"type": "string",
"description": "Display name for the source"
},
"official": {
"type": "boolean",
"description": "Whether this is an official source"
}
}
}
}
}
}
+39
View File
@@ -0,0 +1,39 @@
{
"$schema": "./sources-schema.json",
"version": 1,
"updatedAt": "2026-01-26",
"description": "Curated skill repository sources - THE SINGLE SOURCE OF TRUTH",
"sources": [
{ "source": "anthropics/skills", "name": "Anthropic Official", "official": true },
{ "source": "vercel-labs/agent-skills", "name": "Vercel Labs", "official": true },
{ "source": "expo/skills", "name": "Expo / React Native", "official": true },
{ "source": "remotion-dev/skills", "name": "Remotion Video", "official": true },
{ "source": "supabase/agent-skills", "name": "Supabase", "official": true },
{ "source": "stripe/ai", "name": "Stripe Payments", "official": true },
{ "source": "ComposioHQ/awesome-claude-skills", "name": "Composio Awesome" },
{ "source": "travisvn/awesome-claude-skills", "name": "Travis Awesome" },
{ "source": "mhattingpete/claude-skills-marketplace", "name": "Skills Marketplace" },
{ "source": "coreyhaines31/marketingskills", "name": "Marketing Skills" },
{ "source": "obra/superpowers", "name": "Superpowers TDD" },
{ "source": "softaworks/agent-toolkit", "name": "Softaworks Toolkit" },
{ "source": "wshobson/agents", "name": "Dev Patterns" },
{ "source": "langgenius/dify", "name": "Dify Frontend" },
{ "source": "trailofbits/skills", "name": "Trail of Bits Security" },
{ "source": "better-auth/skills", "name": "Better Auth" },
{ "source": "onmax/nuxt-skills", "name": "Nuxt / Vue" },
{ "source": "hyf0/vue-skills", "name": "Vue Best Practices" },
{ "source": "jezweb/claude-skills", "name": "Cloudflare / TanStack" },
{ "source": "elysiajs/skills", "name": "ElysiaJS / Bun" },
{ "source": "kadajett/agent-nestjs-skills", "name": "NestJS" },
{ "source": "callstackincubator/agent-skills", "name": "React Native" },
{ "source": "cloudai-x/threejs-skills", "name": "Three.js" },
{ "source": "emalorenzo/three-agent-skills", "name": "Three.js Advanced" },
{ "source": "dimillian/skills", "name": "SwiftUI iOS" },
{ "source": "waynesutton/convexskills", "name": "Convex Backend" },
{ "source": "kepano/obsidian-skills", "name": "Obsidian Notes" },
{ "source": "jimliu/baoyu-skills", "name": "Baoyu Tools" },
{ "source": "giuseppe-trisciuoglio/developer-kit", "name": "Shadcn / Radix" },
{ "source": "openrouterteam/agent-skills", "name": "OpenRouter SDK" },
{ "source": "intellectronica/agent-skills", "name": "Context7" }
]
}
+2 -2
View File
@@ -1,12 +1,12 @@
{
"name": "skillkit-monorepo",
"version": "1.6.4",
"version": "1.7.2",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "skillkit-monorepo",
"version": "1.6.4",
"version": "1.7.2",
"license": "Apache-2.0",
"devDependencies": {
"@types/node": "^22.10.5",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "skillkit-monorepo",
"version": "1.7.0",
"version": "1.7.2",
"private": true,
"description": "Universal skills loader for AI coding agents - Monorepo",
"type": "module",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/agents",
"version": "1.7.0",
"version": "1.7.1",
"description": "Agent adapters for SkillKit - supports 17+ AI coding agents",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/cli",
"version": "1.7.0",
"version": "1.7.1",
"description": "CLI commands for SkillKit",
"type": "module",
"main": "./dist/index.js",
+1
View File
@@ -31,6 +31,7 @@ export { PlanCommand } from './plan.js';
export { CommandCmd } from './command.js';
export { AICommand } from './ai.js';
export { AuditCommand } from './audit.js';
export { PublishCommand } from './publish.js';
export {
AgentCommand,
AgentListCommand,
+49
View File
@@ -1,3 +1,6 @@
import { existsSync } from 'node:fs';
import { join } from 'node:path';
import { createInterface } from 'node:readline';
import chalk from 'chalk';
import { Command, Option } from 'clipanion';
import type { AgentType } from '@skillkit/core';
@@ -69,6 +72,9 @@ export class InitCommand extends Command {
console.log(chalk.dim(' 2. Sync config: skillkit sync'));
console.log(chalk.dim(' 3. Use skills: skillkit read <skill-name>'));
// Check if SKILL.md exists and offer to publish
await this.checkAndPromptPublish();
return 0;
} catch (error) {
console.error(chalk.red('Initialization failed'));
@@ -76,4 +82,47 @@ export class InitCommand extends Command {
return 1;
}
}
private async checkAndPromptPublish(): Promise<void> {
// Skip in non-interactive environments (CI, piped input, etc.)
if (!process.stdin.isTTY) return;
const skillMdLocations = [
join(process.cwd(), 'SKILL.md'),
join(process.cwd(), 'skills', 'SKILL.md'),
join(process.cwd(), '.claude', 'skills', 'SKILL.md'),
join(process.cwd(), '.cursor', 'skills', 'SKILL.md'),
];
const foundSkillMd = skillMdLocations.find(loc => existsSync(loc));
if (!foundSkillMd) return;
console.log();
console.log(chalk.yellow('Found SKILL.md in your project!'));
console.log(chalk.dim('Would you like to publish it to the SkillKit marketplace?'));
console.log();
const answer = await this.prompt('Publish skill? [y/N]: ');
if (answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes') {
console.log();
console.log(chalk.cyan('To publish your skill, run:'));
console.log(chalk.white(` skillkit publish ${foundSkillMd}`));
console.log();
}
}
private prompt(question: string): Promise<string> {
const rl = createInterface({
input: process.stdin,
output: process.stdout,
});
return new Promise(resolve => {
rl.question(question, answer => {
rl.close();
resolve(answer.trim());
});
});
}
}
+297
View File
@@ -0,0 +1,297 @@
import { existsSync, readFileSync } from 'node:fs';
import { join, basename, dirname } from 'node:path';
import { execSync } from 'node:child_process';
import chalk from 'chalk';
import { Command, Option } from 'clipanion';
interface SkillFrontmatter {
name?: string;
description?: string;
tags?: string[];
version?: string;
}
export class PublishCommand extends Command {
static override paths = [['publish']];
static override usage = Command.Usage({
description: 'Publish your skill to the SkillKit marketplace',
examples: [
['Publish skill from current directory', '$0 publish'],
['Publish skill from specific path', '$0 publish ./my-skill'],
['Publish with custom name', '$0 publish --name my-awesome-skill'],
],
});
skillPath = Option.String({ required: false, name: 'path' });
name = Option.String('--name,-n', {
description: 'Custom skill name (default: parsed from SKILL.md)',
});
dryRun = Option.Boolean('--dry-run', false, {
description: 'Show what would be published without actually publishing',
});
async execute(): Promise<number> {
const skillPath = this.skillPath || process.cwd();
const skillMdPath = this.findSkillMd(skillPath);
if (!skillMdPath) {
console.error(chalk.red('No SKILL.md found'));
console.error(chalk.dim('Run this command from a directory containing SKILL.md'));
console.error(chalk.dim('Or specify the path: skillkit publish ./path/to/skill'));
return 1;
}
console.log(chalk.cyan('Publishing skill to SkillKit marketplace...\n'));
// Parse SKILL.md
const content = readFileSync(skillMdPath, 'utf-8');
const frontmatter = this.parseFrontmatter(content);
const skillName = this.name || frontmatter.name || basename(dirname(skillMdPath));
// Get git repo info
const repoInfo = this.getRepoInfo(dirname(skillMdPath));
if (!repoInfo) {
console.error(chalk.red('Not a git repository or no remote configured'));
console.error(chalk.dim('Your skill must be in a git repository with a GitHub remote'));
return 1;
}
// Build skill entry
const skillSlug = this.slugify(skillName);
if (!skillSlug) {
console.error(chalk.red('Skill name produces an empty slug.'));
console.error(chalk.dim('Please pass --name with letters or numbers.'));
return 1;
}
const skillEntry = {
id: `${repoInfo.owner}/${repoInfo.repo}/${skillSlug}`,
name: this.formatName(skillName),
description: frontmatter.description || `Best practices and patterns for ${this.formatName(skillName)}`,
source: `${repoInfo.owner}/${repoInfo.repo}`,
tags: frontmatter.tags || this.inferTags(skillName, frontmatter.description || ''),
};
console.log(chalk.white('Skill details:'));
console.log(chalk.dim(` ID: ${skillEntry.id}`));
console.log(chalk.dim(` Name: ${skillEntry.name}`));
console.log(chalk.dim(` Description: ${skillEntry.description}`));
console.log(chalk.dim(` Source: ${skillEntry.source}`));
console.log(chalk.dim(` Tags: ${skillEntry.tags.join(', ')}`));
console.log();
if (this.dryRun) {
console.log(chalk.yellow('Dry run - not publishing'));
console.log(chalk.dim('JSON entry that would be added:'));
console.log(JSON.stringify(skillEntry, null, 2));
return 0;
}
// Create GitHub issue to add skill
const issueBody = this.createIssueBody(skillEntry);
const issueTitle = encodeURIComponent(`[Publish] ${skillEntry.name}`);
const issueBodyEncoded = encodeURIComponent(issueBody);
const issueUrl = `https://github.com/rohitg00/skillkit/issues/new?title=${issueTitle}&body=${issueBodyEncoded}&labels=skill-submission,publish`;
console.log(chalk.green('Opening GitHub to submit your skill...\n'));
try {
// Try to open the URL
const openCmd =
process.platform === 'darwin'
? `open "${issueUrl}"`
: process.platform === 'win32'
? `cmd /c start "" "${issueUrl}"`
: `xdg-open "${issueUrl}"`;
execSync(openCmd, { stdio: 'ignore' });
console.log(chalk.green('GitHub issue page opened!'));
console.log(chalk.dim('Review and submit the issue to publish your skill.'));
} catch {
console.log(chalk.yellow('Could not open browser automatically.'));
console.log(chalk.dim('Please open this URL manually:\n'));
console.log(chalk.cyan(issueUrl));
}
console.log();
console.log(chalk.cyan('Next steps:'));
console.log(chalk.dim(' 1. Review the skill details in the GitHub issue'));
console.log(chalk.dim(' 2. Submit the issue'));
console.log(chalk.dim(' 3. A maintainer will review and add your skill'));
return 0;
}
private findSkillMd(basePath: string): string | null {
// Check if path is directly to SKILL.md
if (basePath.endsWith('SKILL.md') && existsSync(basePath)) {
return basePath;
}
// Check if SKILL.md exists in the directory
const direct = join(basePath, 'SKILL.md');
if (existsSync(direct)) {
return direct;
}
// Check common skill locations
const locations = [
join(basePath, 'skills', 'SKILL.md'),
join(basePath, '.claude', 'skills', 'SKILL.md'),
join(basePath, '.cursor', 'skills', 'SKILL.md'),
];
for (const loc of locations) {
if (existsSync(loc)) {
return loc;
}
}
return null;
}
private parseFrontmatter(content: string): SkillFrontmatter {
const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
if (!match) return {};
const frontmatter: SkillFrontmatter = {};
const lines = match[1].split(/\r?\n/);
let inTagsList = false;
for (const line of lines) {
// Handle multiline tags list
if (inTagsList) {
const tagMatch = line.match(/^\s*-\s*(.+)$/);
if (tagMatch) {
frontmatter.tags ??= [];
frontmatter.tags.push(tagMatch[1].trim().replace(/^["']|["']$/g, ''));
continue;
}
if (line.trim() === '') continue;
inTagsList = false;
}
const colonIdx = line.indexOf(':');
if (colonIdx === -1) continue;
const key = line.slice(0, colonIdx).trim();
const value = line.slice(colonIdx + 1).trim();
switch (key) {
case 'name':
frontmatter.name = value.replace(/^["']|["']$/g, '');
break;
case 'description':
frontmatter.description = value.replace(/^["']|["']$/g, '');
break;
case 'version':
frontmatter.version = value.replace(/^["']|["']$/g, '');
break;
case 'tags':
// Parse YAML array: [tag1, tag2] or multiline list
if (value.startsWith('[')) {
frontmatter.tags = value
.slice(1, -1)
.split(',')
.map(t => t.trim().replace(/^["']|["']$/g, ''))
.filter(t => t.length > 0);
} else if (value === '') {
inTagsList = true;
frontmatter.tags = [];
}
break;
}
}
return frontmatter;
}
private slugify(name: string): string {
return name
.toLowerCase()
.trim()
.replace(/[^a-z0-9]+/g, '-')
.replace(/^-+|-+$/g, '');
}
private getRepoInfo(dir: string): { owner: string; repo: string } | null {
try {
const remote = execSync('git remote get-url origin', {
cwd: dir,
encoding: 'utf-8',
stdio: ['pipe', 'pipe', 'ignore'],
}).trim();
// Parse GitHub URL: git@github.com:owner/repo.git or https://github.com/owner/repo.git
const match = remote.match(/github\.com[:/]([^/]+)\/(.+?)(?:\.git)?$/);
if (match) {
return { owner: match[1], repo: match[2] };
}
} catch {
// Not a git repo or no remote
}
return null;
}
private formatName(name: string): string {
return name
.split(/[-_]/)
.map(word => word.charAt(0).toUpperCase() + word.slice(1))
.join(' ');
}
private inferTags(name: string, description: string): string[] {
const tags: string[] = [];
const text = `${name} ${description}`.toLowerCase();
const tagMap: Record<string, string[]> = {
react: ['react', 'jsx', 'tsx'],
typescript: ['typescript', 'ts'],
nextjs: ['next', 'nextjs'],
testing: ['test', 'jest', 'vitest'],
mobile: ['mobile', 'react-native', 'expo'],
backend: ['backend', 'api', 'server'],
database: ['database', 'postgres', 'mysql', 'supabase'],
frontend: ['frontend', 'ui', 'design'],
devops: ['devops', 'ci', 'cd', 'docker'],
};
for (const [tag, keywords] of Object.entries(tagMap)) {
if (keywords.some(k => text.includes(k))) {
tags.push(tag);
}
}
return tags.length > 0 ? tags : ['general'];
}
private createIssueBody(
skill: { id: string; name: string; description: string; source: string; tags: string[] }
): string {
return `## Publish Skill Request
### Skill Details
- **ID:** \`${skill.id}\`
- **Name:** ${skill.name}
- **Description:** ${skill.description}
- **Source:** [${skill.source}](https://github.com/${skill.source})
- **Tags:** ${skill.tags.map(t => `\`${t}\``).join(', ')}
### JSON Entry
\`\`\`json
${JSON.stringify(skill, null, 2)}
\`\`\`
### Checklist
- [ ] SKILL.md follows the standard format
- [ ] Skill is publicly accessible on GitHub
- [ ] Description accurately describes the skill
- [ ] Tags are appropriate
---
Submitted via \`skillkit publish\``;
}
}
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/core",
"version": "1.7.0",
"version": "1.7.1",
"description": "Core functionality for SkillKit - skill discovery, parsing, and translation",
"type": "module",
"main": "./dist/index.js",
@@ -0,0 +1,99 @@
{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "SkillKit Marketplace",
"description": "Schema for SkillKit marketplace skills index",
"type": "object",
"required": ["version", "skills"],
"properties": {
"version": {
"type": "integer",
"description": "Schema version number"
},
"updatedAt": {
"type": "string",
"format": "date",
"description": "Last update date (YYYY-MM-DD)"
},
"skills": {
"type": "array",
"description": "List of skills in the marketplace",
"items": {
"$ref": "#/definitions/Skill"
}
}
},
"definitions": {
"Skill": {
"type": "object",
"required": ["id", "name", "source", "tags"],
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]+/[a-zA-Z0-9_.-]+/[a-zA-Z0-9_-]+$",
"description": "Unique identifier: owner/repo/skill-name"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Human-readable skill name"
},
"description": {
"type": "string",
"maxLength": 500,
"description": "Brief description of the skill"
},
"source": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]+/[a-zA-Z0-9_.-]+$",
"description": "GitHub repository: owner/repo"
},
"tags": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9-]+$"
},
"minItems": 1,
"maxItems": 10,
"description": "Tags for categorization (lowercase, hyphenated)"
},
"author": {
"type": "string",
"description": "Skill author name or GitHub username"
},
"version": {
"type": "string",
"pattern": "^\\d+\\.\\d+\\.\\d+$",
"description": "Semantic version (e.g., 1.0.0)"
},
"agents": {
"type": "array",
"items": {
"type": "string",
"enum": [
"claude-code",
"cursor",
"codex",
"gemini-cli",
"opencode",
"antigravity",
"amp",
"clawdbot",
"droid",
"github-copilot",
"goose",
"kilo",
"kiro-cli",
"roo",
"trae",
"windsurf",
"universal"
]
},
"description": "Compatible AI agents (omit for universal compatibility)"
}
}
}
}
}
+16 -19
View File
@@ -121,26 +121,23 @@ export interface MarketplaceConfig {
}
/**
* Default skill sources
* Default skill sources - loaded from marketplace/sources.json (single source of truth)
*/
export const DEFAULT_SKILL_SOURCES: SkillSource[] = [
{
owner: 'composioHQ',
repo: 'awesome-claude-code-skills',
name: 'Composio Curated',
description: 'Curated collection of Claude Code skills',
official: false,
branch: 'main',
},
{
owner: 'anthropics',
repo: 'courses',
name: 'Anthropic Official',
description: 'Official Anthropic courses and skills',
official: true,
branch: 'master',
},
];
import sourcesData from '../../../../marketplace/sources.json' with { type: 'json' };
export const DEFAULT_SKILL_SOURCES: SkillSource[] = sourcesData.sources.map(
(s: { source: string; name: string; official?: boolean }) => {
const [owner, repo] = s.source.split('/');
return {
owner,
repo,
name: s.name,
description: `Skills from ${s.name}`,
official: s.official || false,
branch: 'main',
};
}
);
/**
* Cache file name
+8 -33
View File
@@ -7,40 +7,15 @@ import { join } from 'node:path';
import type { SkillItem, RepoInfo, FetchedSkill } from './types.js';
/**
* Default popular repos - can be extended via config.marketplaceSources
* Default repos loaded from marketplace/sources.json (single source of truth)
* Import at runtime to allow updates without code changes
*/
export const DEFAULT_REPOS: RepoInfo[] = [
{ source: 'anthropics/skills', name: 'Anthropic Official' },
{ source: 'vercel-labs/agent-skills', name: 'Vercel Labs' },
{ source: 'expo/skills', name: 'Expo / React Native' },
{ source: 'remotion-dev/skills', name: 'Remotion Video' },
{ source: 'ComposioHQ/awesome-claude-skills', name: 'Composio Awesome' },
{ source: 'travisvn/awesome-claude-skills', name: 'Travis Awesome' },
{ source: 'mhattingpete/claude-skills-marketplace', name: 'Skills Marketplace' },
{ source: 'coreyhaines31/marketingskills', name: 'Marketing Skills' },
{ source: 'obra/superpowers', name: 'Superpowers TDD' },
{ source: 'softaworks/agent-toolkit', name: 'Softaworks Toolkit' },
{ source: 'wshobson/agents', name: 'Dev Patterns' },
{ source: 'langgenius/dify', name: 'Dify Frontend' },
{ source: 'trailofbits/skills', name: 'Trail of Bits Security' },
{ source: 'better-auth/skills', name: 'Better Auth' },
{ source: 'onmax/nuxt-skills', name: 'Nuxt / Vue' },
{ source: 'hyf0/vue-skills', name: 'Vue Best Practices' },
{ source: 'jezweb/claude-skills', name: 'Cloudflare / TanStack' },
{ source: 'elysiajs/skills', name: 'ElysiaJS / Bun' },
{ source: 'kadajett/agent-nestjs-skills', name: 'NestJS' },
{ source: 'callstackincubator/agent-skills', name: 'React Native' },
{ source: 'cloudai-x/threejs-skills', name: 'Three.js' },
{ source: 'emalorenzo/three-agent-skills', name: 'Three.js Advanced' },
{ source: 'dimillian/skills', name: 'SwiftUI iOS' },
{ source: 'stripe/ai', name: 'Stripe Payments' },
{ source: 'waynesutton/convexskills', name: 'Convex Backend' },
{ source: 'kepano/obsidian-skills', name: 'Obsidian Notes' },
{ source: 'jimliu/baoyu-skills', name: 'Baoyu Tools' },
{ source: 'giuseppe-trisciuoglio/developer-kit', name: 'Shadcn / Radix' },
{ source: 'openrouterteam/agent-skills', name: 'OpenRouter SDK' },
{ source: 'intellectronica/agent-skills', name: 'Context7' },
];
import sourcesData from '../../../../marketplace/sources.json' with { type: 'json' };
export const DEFAULT_REPOS: RepoInfo[] = sourcesData.sources.map((s: { source: string; name: string }) => ({
source: s.source,
name: s.name,
}));
/**
* Marketplace state
-58
View File
@@ -1,58 +0,0 @@
import { useState } from 'react';
import { Box, Text, useInput, useApp, useStdout } from 'ink';
import { Sidebar } from './components/Sidebar.js';
import { Home } from './screens/Home.js';
import { Browse } from './screens/Browse.js';
import { Installed } from './screens/Installed.js';
import { Sync } from './screens/Sync.js';
import { Settings } from './screens/Settings.js';
export type Screen = 'home' | 'browse' | 'installed' | 'sync' | 'settings';
export function App() {
const [screen, setScreen] = useState<Screen>('home');
const { exit } = useApp();
const { stdout } = useStdout();
const cols = stdout?.columns || 80;
const rows = stdout?.rows || 24;
const showSidebar = cols >= 70;
useInput((input, key) => {
if (input === 'q') {
exit();
return;
}
if (key.escape) {
setScreen('home');
return;
}
if (input === 'h') setScreen('home');
if (input === 'b') setScreen('browse');
if (input === 'l') setScreen('installed');
if (input === 's') setScreen('sync');
if (input === ',') setScreen('settings');
});
const renderScreen = () => {
switch (screen) {
case 'home': return <Home onNavigate={setScreen} cols={cols} rows={rows} />;
case 'browse': return <Browse cols={cols} rows={rows} />;
case 'installed': return <Installed cols={cols} rows={rows} />;
case 'sync': return <Sync cols={cols} rows={rows} />;
case 'settings': return <Settings cols={cols} rows={rows} />;
}
};
return (
<Box flexDirection="column">
<Box flexDirection="row" flexGrow={1}>
{showSidebar && <Sidebar screen={screen} onNavigate={setScreen} />}
<Box flexDirection="column" flexGrow={1} marginLeft={1}>
{renderScreen()}
</Box>
</Box>
<Text dimColor>h Home b Browse l List s Sync , Config Esc Back q Quit</Text>
</Box>
);
}
-30
View File
@@ -1,30 +0,0 @@
import { Box, Text } from 'ink';
import { colors, symbols } from '../theme.js';
interface HeaderProps {
title: string;
subtitle?: string;
count?: number;
}
export function Header({ title, subtitle, count }: HeaderProps) {
return (
<Box flexDirection="column" marginBottom={1}>
<Box justifyContent="space-between">
<Text color={colors.primary} bold>
{title.toUpperCase()}
</Text>
{count !== undefined && (
<Text color={colors.secondaryDim}>
{symbols.star} {count}
</Text>
)}
</Box>
{subtitle && (
<Text color={colors.secondaryDim} dimColor>
{subtitle}
</Text>
)}
</Box>
);
}
-40
View File
@@ -1,40 +0,0 @@
import { Box, Text } from 'ink';
import TextInput from 'ink-text-input';
import { colors } from '../theme.js';
interface SearchInputProps {
value: string;
onChange: (value: string) => void;
placeholder?: string;
isFocused?: boolean;
}
export function SearchInput({
value,
onChange,
placeholder = 'Search skills...',
isFocused = false,
}: SearchInputProps) {
return (
<Box
borderStyle="single"
borderColor={isFocused ? colors.primary : colors.borderDim}
paddingX={1}
>
<Text color={colors.secondaryDim}>🔍 </Text>
{isFocused ? (
<TextInput
value={value}
onChange={onChange}
placeholder={placeholder}
/>
) : (
<Text color={value ? colors.secondary : colors.secondaryDim}>
{value || placeholder}
</Text>
)}
<Box flexGrow={1} />
<Text color={colors.secondaryDim}>/</Text>
</Box>
);
}
-44
View File
@@ -1,44 +0,0 @@
import { Box, Text } from 'ink';
import { colors, symbols } from '../theme.js';
import type { Screen } from '../App.js';
interface SidebarProps {
screen: Screen;
onNavigate: (screen: Screen) => void;
isCompact?: boolean;
}
const NAV: { id: Screen; label: string }[] = [
{ id: 'home', label: 'Home' },
{ id: 'browse', label: 'Browse' },
{ id: 'installed', label: 'List' },
{ id: 'sync', label: 'Sync' },
{ id: 'settings', label: 'Config' },
];
export function Sidebar({ screen }: SidebarProps) {
return (
<Box flexDirection="column" width={14} borderStyle="single" paddingX={1}>
<Text bold color={colors.primary}>SkillKit</Text>
{NAV.slice(0, 2).map((item) => (
<Text key={item.id} inverse={screen === item.id}>
{screen === item.id ? symbols.bullet : ' '}{item.label}
</Text>
))}
<Text> </Text>
{NAV.slice(2).map((item) => (
<Text key={item.id} inverse={screen === item.id}>
{screen === item.id ? symbols.bullet : ' '}{item.label}
</Text>
))}
<Box flexGrow={1} />
<Text dimColor>? Help</Text>
<Text dimColor>q Quit</Text>
</Box>
);
}
-103
View File
@@ -1,103 +0,0 @@
import { Box, Text } from 'ink';
import { colors, symbols } from '../theme.js';
export interface SkillItem {
name: string;
description?: string;
source?: string;
installs?: number;
enabled?: boolean;
}
interface SkillListProps {
skills: SkillItem[];
selectedIndex: number;
showInstalls?: boolean;
showRank?: boolean;
showSource?: boolean;
maxVisible?: number;
}
function formatInstalls(count: number): string {
if (count >= 1000) {
return `${(count / 1000).toFixed(1)}K`;
}
return String(count);
}
export function SkillList({
skills,
selectedIndex,
showInstalls = false,
showRank = false,
showSource = true,
maxVisible = 10,
}: SkillListProps) {
if (skills.length === 0) {
return (
<Box>
<Text color={colors.secondaryDim} dimColor>
No skills found
</Text>
</Box>
);
}
const startIndex = Math.max(0, selectedIndex - Math.floor(maxVisible / 2));
const visibleSkills = skills.slice(startIndex, startIndex + maxVisible);
const actualStartIndex = startIndex;
return (
<Box flexDirection="column">
{showRank && (
<Box marginBottom={1}>
<Text color={colors.secondaryDim}>
{' # SKILL'}
{showSource && ' SOURCE'}
{showInstalls && ' INSTALLS'}
</Text>
</Box>
)}
{visibleSkills.map((skill, idx) => {
const realIndex = actualStartIndex + idx;
const isSelected = realIndex === selectedIndex;
const skillName = skill.name.padEnd(28).slice(0, 28);
const sourceName = skill.source ? skill.source.slice(0, 25) : '';
return (
<Box key={`${skill.source}-${skill.name}`}>
<Text
color={isSelected ? colors.primary : colors.secondary}
bold={isSelected}
inverse={isSelected}
>
{isSelected ? symbols.pointer : ' '}
{showRank ? String(realIndex + 1).padStart(2, ' ') : ''}
{' '}
{skillName}
</Text>
{showSource && (
<Text color={colors.secondaryDim} dimColor={!isSelected}>
{' '}{sourceName}
</Text>
)}
{showInstalls && skill.installs !== undefined && (
<Text color={colors.secondaryDim}>
{formatInstalls(skill.installs).padStart(8)}
</Text>
)}
</Box>
);
})}
{skills.length > maxVisible && (
<Box marginTop={1}>
<Text color={colors.secondaryDim} dimColor>
Showing {startIndex + 1}-{Math.min(startIndex + maxVisible, skills.length)} of {skills.length}
</Text>
</Box>
)}
</Box>
);
}
-44
View File
@@ -1,44 +0,0 @@
import { Box, Text } from 'ink';
import { colors, symbols } from '../theme.js';
interface Shortcut {
key: string;
label: string;
}
interface StatusBarProps {
shortcuts: Shortcut[];
message?: string;
}
export function StatusBar({ shortcuts, message }: StatusBarProps) {
return (
<Box
borderStyle="single"
borderColor={colors.borderDim}
borderTop
borderBottom={false}
borderLeft={false}
borderRight={false}
paddingX={1}
justifyContent="space-between"
>
<Box gap={2}>
{shortcuts.map((shortcut, idx) => (
<Box key={idx} gap={1}>
<Text color={colors.primary} bold>
{shortcut.key}
</Text>
<Text color={colors.secondaryDim}>{shortcut.label}</Text>
</Box>
))}
</Box>
{message && (
<Text color={colors.success}>
{symbols.check} {message}
</Text>
)}
</Box>
);
}
-5
View File
@@ -1,5 +0,0 @@
export { Sidebar } from './Sidebar.js';
export { Header } from './Header.js';
export { SkillList, type SkillItem } from './SkillList.js';
export { StatusBar } from './StatusBar.js';
export { SearchInput } from './SearchInput.js';
-3
View File
@@ -1,3 +0,0 @@
export { useSkills } from './useSkills.js';
export { useMarketplace } from './useMarketplace.js';
export { useKeyboard, useListNavigation } from './useKeyboard.js';
-93
View File
@@ -1,93 +0,0 @@
import { useState, useCallback, useEffect } from 'react';
import { useInput, useApp } from 'ink';
import type { Screen } from '../App.js';
interface UseKeyboardOptions {
onNavigate?: (screen: Screen) => void;
onSelect?: () => void;
onSearch?: () => void;
onInstall?: () => void;
onBack?: () => void;
onUp?: () => void;
onDown?: () => void;
disabled?: boolean;
}
export function useKeyboard(options: UseKeyboardOptions = {}) {
const { exit } = useApp();
useInput((input, key) => {
if (options.disabled) return;
if (input === 'q' || (key.ctrl && input === 'c')) {
exit();
return;
}
if (key.escape && options.onBack) {
options.onBack();
return;
}
if (key.return && options.onSelect) {
options.onSelect();
return;
}
if (key.upArrow && options.onUp) {
options.onUp();
return;
}
if (key.downArrow && options.onDown) {
options.onDown();
return;
}
if (input === '/' && options.onSearch) {
options.onSearch();
return;
}
if (input === 'i' && options.onInstall) {
options.onInstall();
return;
}
if (input === 'h' && options.onNavigate) {
options.onNavigate('home');
} else if (input === 'b' && options.onNavigate) {
options.onNavigate('browse');
} else if (input === 'l' && options.onNavigate) {
options.onNavigate('installed');
} else if (input === 's' && options.onNavigate) {
options.onNavigate('sync');
} else if (input === ',' && options.onNavigate) {
options.onNavigate('settings');
}
});
}
export function useListNavigation(listLength: number, initialIndex = 0) {
const [selectedIndex, setSelectedIndex] = useState(initialIndex);
useEffect(() => {
if (selectedIndex >= listLength && listLength > 0) {
setSelectedIndex(listLength - 1);
}
}, [listLength, selectedIndex]);
const moveUp = useCallback(() => {
setSelectedIndex((prev) => Math.max(0, prev - 1));
}, []);
const moveDown = useCallback(() => {
setSelectedIndex((prev) => Math.min(listLength - 1, prev + 1));
}, [listLength]);
const reset = useCallback(() => {
setSelectedIndex(0);
}, []);
return { selectedIndex, setSelectedIndex, moveUp, moveDown, reset };
}
-181
View File
@@ -1,181 +0,0 @@
import { useState, useCallback, useEffect } from 'react';
import { detectProvider } from '../../providers/index.js';
import type { SkillItem } from '../components/SkillList.js';
export interface RepoInfo {
source: string;
name: string;
}
const POPULAR_REPOS: RepoInfo[] = [
{ source: 'anthropics/skills', name: 'Anthropic Official' },
{ source: 'vercel-labs/agent-skills', name: 'Vercel Labs' },
{ source: 'expo/skills', name: 'Expo / React Native' },
{ source: 'remotion-dev/skills', name: 'Remotion Video' },
{ source: 'ComposioHQ/awesome-claude-skills', name: 'Composio Awesome' },
{ source: 'travisvn/awesome-claude-skills', name: 'Travis Awesome' },
{ source: 'mhattingpete/claude-skills-marketplace', name: 'Skills Marketplace' },
{ source: 'coreyhaines31/marketingskills', name: 'Marketing Skills' },
{ source: 'obra/superpowers', name: 'Superpowers TDD' },
{ source: 'softaworks/agent-toolkit', name: 'Softaworks Toolkit' },
{ source: 'wshobson/agents', name: 'Dev Patterns' },
{ source: 'langgenius/dify', name: 'Dify Frontend' },
{ source: 'trailofbits/skills', name: 'Trail of Bits Security' },
{ source: 'better-auth/skills', name: 'Better Auth' },
{ source: 'onmax/nuxt-skills', name: 'Nuxt / Vue' },
{ source: 'hyf0/vue-skills', name: 'Vue Best Practices' },
{ source: 'jezweb/claude-skills', name: 'Cloudflare / TanStack' },
{ source: 'elysiajs/skills', name: 'ElysiaJS / Bun' },
{ source: 'kadajett/agent-nestjs-skills', name: 'NestJS' },
{ source: 'callstackincubator/agent-skills', name: 'React Native' },
{ source: 'cloudai-x/threejs-skills', name: 'Three.js' },
{ source: 'emalorenzo/three-agent-skills', name: 'Three.js Advanced' },
{ source: 'dimillian/skills', name: 'SwiftUI iOS' },
{ source: 'stripe/ai', name: 'Stripe Payments' },
{ source: 'waynesutton/convexskills', name: 'Convex Backend' },
{ source: 'kepano/obsidian-skills', name: 'Obsidian Notes' },
{ source: 'jimliu/baoyu-skills', name: 'Baoyu Tools' },
{ source: 'giuseppe-trisciuoglio/developer-kit', name: 'Shadcn / Radix' },
{ source: 'openrouterteam/agent-skills', name: 'OpenRouter SDK' },
{ source: 'intellectronica/agent-skills', name: 'Context7' },
{ source: 'alirezarezvani/claude-skills', name: 'Alireza Rezvani' },
];
interface FetchedSkill {
name: string;
source: string;
repoName: string;
description?: string;
}
interface UseMarketplaceResult {
skills: SkillItem[];
loading: boolean;
error: string | null;
totalCount: number;
repos: RepoInfo[];
currentRepo: string | null;
refresh: () => void;
search: (query: string) => void;
fetchRepo: (source: string) => Promise<void>;
fetchAllRepos: () => Promise<void>;
}
export function useMarketplace(): UseMarketplaceResult {
const [allSkills, setAllSkills] = useState<FetchedSkill[]>([]);
const [filteredSkills, setFilteredSkills] = useState<FetchedSkill[]>([]);
const [loading, setLoading] = useState(false);
const [error, setError] = useState<string | null>(null);
const [currentRepo, setCurrentRepo] = useState<string | null>(null);
const [fetchedRepos, setFetchedRepos] = useState<Set<string>>(new Set());
const fetchRepo = useCallback(async (source: string) => {
if (fetchedRepos.has(source)) return;
setLoading(true);
setError(null);
setCurrentRepo(source);
try {
const provider = detectProvider(source);
if (!provider) {
throw new Error(`Could not detect provider for: ${source}`);
}
const result = await provider.clone(source, '', { depth: 1 });
if (!result.success || !result.discoveredSkills) {
throw new Error(result.error || 'Failed to fetch skills');
}
const repoName = POPULAR_REPOS.find(r => r.source === source)?.name || source;
const newSkills: FetchedSkill[] = result.discoveredSkills.map(skill => ({
name: skill.name,
source: source,
repoName: repoName,
description: undefined,
}));
setAllSkills(prev => {
const updated = [...prev, ...newSkills];
return updated.sort((a, b) => a.name.localeCompare(b.name));
});
setFetchedRepos(prev => new Set([...prev, source]));
if (result.tempRoot) {
const { rmSync } = await import('node:fs');
rmSync(result.tempRoot, { recursive: true, force: true });
}
} catch (err) {
setError(err instanceof Error ? err.message : 'Failed to fetch repository');
} finally {
setLoading(false);
setCurrentRepo(null);
}
}, [fetchedRepos]);
const fetchAllRepos = useCallback(async () => {
setLoading(true);
setError(null);
for (const repo of POPULAR_REPOS) {
if (!fetchedRepos.has(repo.source)) {
setCurrentRepo(repo.source);
try {
await fetchRepo(repo.source);
} catch {
}
}
}
setLoading(false);
setCurrentRepo(null);
}, [fetchRepo, fetchedRepos]);
const search = useCallback((query: string) => {
if (!query.trim()) {
setFilteredSkills(allSkills);
} else {
const lowerQuery = query.toLowerCase();
setFilteredSkills(
allSkills.filter(
(s) =>
s.name.toLowerCase().includes(lowerQuery) ||
s.source.toLowerCase().includes(lowerQuery) ||
s.repoName.toLowerCase().includes(lowerQuery) ||
s.description?.toLowerCase().includes(lowerQuery)
)
);
}
}, [allSkills]);
const refresh = useCallback(() => {
setFetchedRepos(new Set());
setAllSkills([]);
setFilteredSkills([]);
}, []);
useEffect(() => {
setFilteredSkills(allSkills);
}, [allSkills]);
const skills: SkillItem[] = filteredSkills.map((s) => ({
name: s.name,
description: s.description || s.repoName,
source: s.source,
}));
return {
skills,
loading,
error,
totalCount: allSkills.length,
repos: POPULAR_REPOS,
currentRepo,
refresh,
search,
fetchRepo,
fetchAllRepos,
};
}
-61
View File
@@ -1,61 +0,0 @@
import { useState, useEffect } from 'react';
import { getSearchDirs } from '../../core/config.js';
import { findAllSkills } from '../../core/skills.js';
import type { SkillItem } from '../components/SkillList.js';
interface UseSkillsResult {
skills: SkillItem[];
loading: boolean;
error: string | null;
refresh: () => void;
remove: (name: string) => Promise<void>;
}
export function useSkills(): UseSkillsResult {
const [skills, setSkills] = useState<SkillItem[]>([]);
const [loading, setLoading] = useState(true);
const [error, setError] = useState<string | null>(null);
const refresh = () => {
setLoading(true);
setError(null);
try {
const searchDirs = getSearchDirs();
const foundSkills = findAllSkills(searchDirs);
const skillItems: SkillItem[] = foundSkills.map((s) => ({
name: s.name,
description: s.description,
source: s.metadata?.source,
enabled: s.enabled,
}));
setSkills(skillItems);
} catch (err) {
setError(err instanceof Error ? err.message : 'Failed to load skills');
} finally {
setLoading(false);
}
};
const remove = async (name: string) => {
const { rmSync } = await import('node:fs');
const foundSkill = skills.find(s => s.name === name);
if (foundSkill) {
const searchDirs = getSearchDirs();
const allSkills = findAllSkills(searchDirs);
const skill = allSkills.find(s => s.name === name);
if (skill) {
rmSync(skill.path, { recursive: true, force: true });
refresh();
}
}
};
useEffect(() => {
refresh();
}, []);
return { skills, loading, error, refresh, remove };
}
-7
View File
@@ -1,7 +0,0 @@
import { render } from 'ink';
import { App } from './App.js';
export function startTUI() {
const { waitUntilExit } = render(<App />);
return waitUntilExit();
}
-223
View File
@@ -1,223 +0,0 @@
import { useState } from 'react';
import { existsSync, mkdirSync, cpSync, rmSync } from 'node:fs';
import { join } from 'node:path';
import { Box, Text, useInput } from 'ink';
import { colors, symbols } from '../theme.js';
import { useMarketplace } from '../hooks/useMarketplace.js';
import { detectProvider } from '../../providers/index.js';
import { detectAgent, getAdapter, getAllAdapters } from '../../agents/index.js';
import { getInstallDir, saveSkillMetadata } from '../../core/config.js';
import type { SkillMetadata, AgentType } from '../../core/types.js';
type View = 'repos' | 'skills' | 'agents';
interface Props {
cols?: number;
rows?: number;
}
export function Browse({ rows = 24 }: Props) {
const { repos, skills, loading, currentRepo, fetchRepo, fetchAllRepos } = useMarketplace();
const [view, setView] = useState<View>('repos');
const [sel, setSel] = useState(0);
const [installing, setInstalling] = useState<string | null>(null);
const [message, setMessage] = useState<string | null>(null);
const [selectedSkill, setSelectedSkill] = useState<{ name: string; source: string } | null>(null);
const [agents, setAgents] = useState<{ type: AgentType; name: string; detected: boolean }[]>([]);
const items = view === 'repos' ? repos : view === 'skills' ? skills : agents;
const maxVisible = Math.max(5, rows - 8);
const start = Math.max(0, Math.min(sel - Math.floor(maxVisible / 2), items.length - maxVisible));
const visible = items.slice(start, start + maxVisible);
const showAgentSelection = async (skillName: string, source: string) => {
setSelectedSkill({ name: skillName, source });
const adapters = getAllAdapters();
const agentList: typeof agents = [];
for (const a of adapters) {
agentList.push({
type: a.type as AgentType,
name: a.name,
detected: await a.isDetected(),
});
}
setAgents(agentList);
setView('agents');
setSel(0);
};
const installSkill = async (skillName: string, source: string, agentType?: AgentType) => {
setInstalling(skillName);
setMessage(null);
try {
const provider = detectProvider(source);
if (!provider) {
setMessage(`Error: Unknown provider for ${source}`);
setInstalling(null);
return;
}
const result = await provider.clone(source, '', { depth: 1 });
if (!result.success || !result.discoveredSkills) {
setMessage(`Error: ${result.error || 'Failed to fetch'}`);
setInstalling(null);
return;
}
const skill = result.discoveredSkills.find(s => s.name === skillName);
if (!skill) {
setMessage(`Error: Skill ${skillName} not found`);
setInstalling(null);
return;
}
const targetAgentType = agentType || await detectAgent();
const adapter = getAdapter(targetAgentType);
const installDir = getInstallDir(false, targetAgentType);
if (!existsSync(installDir)) {
mkdirSync(installDir, { recursive: true });
}
const targetPath = join(installDir, skillName);
if (existsSync(targetPath)) {
rmSync(targetPath, { recursive: true, force: true });
}
cpSync(skill.path, targetPath, { recursive: true, dereference: true });
const metadata: SkillMetadata = {
name: skillName,
description: '',
source: source,
sourceType: provider.type,
subpath: skillName,
installedAt: new Date().toISOString(),
enabled: true,
};
saveSkillMetadata(targetPath, metadata);
if (result.tempRoot) {
rmSync(result.tempRoot, { recursive: true, force: true });
}
setMessage(`✓ Installed ${skillName} to ${adapter.name}`);
if (!agentType) {
setView('skills');
}
} catch (err) {
setMessage(`Error: ${err instanceof Error ? err.message : 'Unknown error'}`);
} finally {
setInstalling(null);
if (agentType) {
setSelectedSkill(null);
}
}
};
useInput((input, key) => {
if (loading || installing) return;
if (key.upArrow) setSel(i => Math.max(0, i - 1));
else if (key.downArrow) setSel(i => Math.min(items.length - 1, i + 1));
else if (key.return) {
if (view === 'repos' && repos[sel]) {
fetchRepo(repos[sel].source);
setView('skills');
setSel(0);
setMessage(null);
} else if (view === 'skills' && skills[sel]?.source) {
installSkill(skills[sel].name, skills[sel].source);
} else if (view === 'agents' && agents[sel]) {
installSkill(selectedSkill!.name, selectedSkill!.source, agents[sel].type);
}
}
else if (input === 'm' && view === 'skills' && skills[sel]?.source) {
showAgentSelection(skills[sel].name, skills[sel].source!);
}
else if (input === 'r') {
if (view === 'skills') {
setView('repos');
setSel(0);
setMessage(null);
} else if (view === 'agents') {
setView('skills');
setSel(0);
}
}
else if (input === 'a' && view === 'repos') {
fetchAllRepos();
setView('skills');
setSel(0);
}
});
if (view === 'agents') {
return (
<Box flexDirection="column">
<Text bold color={colors.primary}>SELECT AGENT</Text>
<Text dimColor>Install "{selectedSkill?.name}" to which agent?</Text>
<Text dimColor>(All agents supported - directory created if needed)</Text>
<Box marginTop={1} flexDirection="column">
{visible.map((agent, i) => {
const idx = start + i;
const isSel = idx === sel;
const a = agent as typeof agents[0];
const status = a.detected ? '(ready)' : '(will create)';
return (
<Text key={a.type} inverse={isSel}>
{isSel ? symbols.pointer : ' '} {a.name.padEnd(20)} <Text color={colors.secondaryDim}>{status}</Text>
</Text>
);
})}
</Box>
<Box marginTop={1}>
<Text dimColor>Enter=install to selected agent r=back q=quit</Text>
</Box>
</Box>
);
}
return (
<Box flexDirection="column">
<Text bold color={colors.primary}>{view === 'repos' ? 'REPOSITORIES' : 'SKILLS'}</Text>
{loading && <Text dimColor>Loading {currentRepo}...</Text>}
{installing && <Text>Installing {installing}...</Text>}
{message && <Text dimColor>{message}</Text>}
<Text dimColor>{items.length} items</Text>
<Box marginTop={1} flexDirection="column">
{start > 0 && <Text dimColor> ↑ {start} more</Text>}
{visible.map((item, i) => {
const idx = start + i;
const isSel = idx === sel;
const name = view === 'repos'
? (item as typeof repos[0]).name
: (item as typeof skills[0]).name;
const src = view === 'repos'
? (item as typeof repos[0]).source
: (item as typeof skills[0]).source || '';
return (
<Text key={src + name} inverse={isSel}>
{isSel ? symbols.pointer : ' '}{name.padEnd(25)} <Text color={colors.secondaryDim}>{src}</Text>
</Text>
);
})}
{start + maxVisible < items.length && <Text dimColor> ↓ {items.length - start - maxVisible} more</Text>}
</Box>
<Box marginTop={1}>
<Text dimColor>
{view === 'repos'
? 'Enter=fetch a=all q=quit'
: 'Enter=quick install m=choose agent r=back q=quit'}
</Text>
</Box>
</Box>
);
}
-98
View File
@@ -1,98 +0,0 @@
import { useState, useEffect } from 'react';
import { readFileSync } from 'node:fs';
import { fileURLToPath } from 'node:url';
import { dirname, join } from 'node:path';
import { Box, Text } from 'ink';
import { colors, logo } from '../theme.js';
import type { Screen } from '../App.js';
interface HomeProps {
onNavigate: (screen: Screen) => void;
cols?: number;
rows?: number;
}
const CHARS = '01█▓▒░╔╗╚╝║═';
const logoSmall = `
╔═╗╦╔═╦╦ ╦ ╦╔═╦╔╦╗
╚═╗╠╩╗║║ ║ ╠╩╗║ ║
╚═╝╩ ╩╩╩═╝╩═╝╩ ╩╩ ╩
`.trim();
function getVersion(): string {
try {
const __filename = fileURLToPath(import.meta.url);
const __dirname = dirname(__filename);
const packageJsonPath = join(__dirname, '../../../package.json');
const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
return packageJson.version || '1.2.0';
} catch {
return '1.2.0';
}
}
function scramble(target: string, progress: number): string {
return target.split('\n').map(line => {
return line.split('').map((char, i) => {
if (char === ' ') return char;
if (progress > (i / line.length) * 100) return char;
return CHARS[Math.floor(Math.random() * CHARS.length)];
}).join('');
}).join('\n');
}
export function Home({ cols = 80, rows = 24 }: HomeProps) {
const [progress, setProgress] = useState(0);
const [display, setDisplay] = useState('');
const version = getVersion();
const useLogo = cols < 80 ? logoSmall : logo;
useEffect(() => {
if (progress >= 100) {
setDisplay(useLogo);
return;
}
const t = setInterval(() => {
setProgress(p => {
const next = p + 12;
setDisplay(scramble(useLogo, next));
return next;
});
}, 35);
return () => clearInterval(t);
}, [progress, useLogo]);
return (
<Box flexDirection="column">
<Text color={colors.primary}>{display || useLogo}</Text>
<Box marginTop={1}>
<Text>Manage AI agent skills from your terminal.</Text>
</Box>
<Box marginTop={1} flexDirection="column">
<Text bold>Quick Actions:</Text>
<Text dimColor> [b] Browse skills marketplace</Text>
<Text dimColor> [l] View installed skills</Text>
<Text dimColor> [s] Sync skills across agents</Text>
<Text dimColor> [,] Settings</Text>
</Box>
{rows >= 18 && (
<Box marginTop={1} flexDirection="column">
<Text bold>Navigation:</Text>
<Text dimColor> ↑↓ Navigate lists</Text>
<Text dimColor> Enter Select / Confirm</Text>
<Text dimColor> Esc Go back / Home</Text>
<Text dimColor> q Quit</Text>
</Box>
)}
<Box marginTop={1}>
<Text dimColor>v{version} - Works with 17 AI agents</Text>
</Box>
</Box>
);
}
-59
View File
@@ -1,59 +0,0 @@
import { useState } from 'react';
import { Box, Text, useInput } from 'ink';
import { colors, symbols } from '../theme.js';
import { useSkills } from '../hooks/useSkills.js';
interface Props {
cols?: number;
rows?: number;
}
export function Installed({ rows = 24 }: Props) {
const { skills, loading, refresh, remove } = useSkills();
const [sel, setSel] = useState(0);
const maxVisible = Math.max(5, rows - 6);
const start = Math.max(0, Math.min(sel - Math.floor(maxVisible / 2), skills.length - maxVisible));
const visible = skills.slice(start, start + maxVisible);
useInput((input, key) => {
if (loading) return;
if (key.upArrow) setSel(i => Math.max(0, i - 1));
else if (key.downArrow) setSel(i => Math.min(skills.length - 1, i + 1));
else if (input === 'r') refresh();
else if (input === 'd' && skills[sel]) remove(skills[sel].name);
});
return (
<Box flexDirection="column">
<Text bold color={colors.primary}>INSTALLED SKILLS</Text>
<Text dimColor>{skills.length} skills</Text>
{loading && <Text>Loading...</Text>}
{!loading && skills.length === 0 && (
<Text dimColor>No skills installed. Press b to browse.</Text>
)}
{!loading && skills.length > 0 && (
<Box marginTop={1} flexDirection="column">
{start > 0 && <Text dimColor> ↑ {start} more</Text>}
{visible.map((skill, i) => {
const idx = start + i;
const isSel = idx === sel;
return (
<Text key={skill.name} inverse={isSel}>
{isSel ? symbols.pointer : ' '}{skill.name.padEnd(30)} {skill.source && <Text color={colors.secondaryDim}>{skill.source}</Text>}
</Text>
);
})}
{start + maxVisible < skills.length && <Text dimColor> ↓ {skills.length - start - maxVisible} more</Text>}
</Box>
)}
<Box marginTop={1}>
<Text dimColor>r=refresh d=delete q=quit</Text>
</Box>
</Box>
);
}
-45
View File
@@ -1,45 +0,0 @@
import { useState } from 'react';
import { Box, Text, useInput } from 'ink';
import { colors, symbols } from '../theme.js';
interface Props {
cols?: number;
rows?: number;
}
const SETTINGS = [
{ id: 'agent', label: 'Default Agent', value: 'auto-detect' },
{ id: 'sync', label: 'Auto Sync', value: 'disabled' },
{ id: 'cache', label: 'Cache Dir', value: '~/.skillkit/cache' },
];
export function Settings({}: Props) {
const [sel, setSel] = useState(0);
useInput((_, key) => {
if (key.upArrow) setSel(i => Math.max(0, i - 1));
else if (key.downArrow) setSel(i => Math.min(SETTINGS.length - 1, i + 1));
});
return (
<Box flexDirection="column">
<Text bold color={colors.primary}>SETTINGS</Text>
<Text dimColor>Configure SkillKit</Text>
<Box marginTop={1} flexDirection="column">
{SETTINGS.map((s, i) => {
const isSel = i === sel;
return (
<Text key={s.id} inverse={isSel}>
{isSel ? symbols.pointer : ' '}{s.label.padEnd(16)} <Text color={colors.secondaryDim}>{s.value}</Text>
</Text>
);
})}
</Box>
<Box marginTop={1}>
<Text dimColor>Enter=edit q=quit</Text>
</Box>
</Box>
);
}
-78
View File
@@ -1,78 +0,0 @@
import { useState, useEffect } from 'react';
import { Box, Text, useInput } from 'ink';
import { colors, symbols } from '../theme.js';
import { getAllAdapters } from '../../agents/index.js';
interface AgentStatus {
name: string;
type: string;
detected: boolean;
}
interface Props {
cols?: number;
rows?: number;
}
export function Sync({ rows = 24 }: Props) {
const [agents, setAgents] = useState<AgentStatus[]>([]);
const [loading, setLoading] = useState(true);
const [sel, setSel] = useState(0);
const [syncing, setSyncing] = useState(false);
const maxVisible = Math.max(5, rows - 6);
const start = Math.max(0, Math.min(sel - Math.floor(maxVisible / 2), agents.length - maxVisible));
const visible = agents.slice(start, start + maxVisible);
useEffect(() => {
(async () => {
const adapters = getAllAdapters();
const s: AgentStatus[] = [];
for (const a of adapters) {
s.push({ name: a.name, type: a.type, detected: await a.isDetected() });
}
setAgents(s);
setLoading(false);
})();
}, []);
useInput((input, key) => {
if (loading || syncing) return;
if (key.upArrow) setSel(i => Math.max(0, i - 1));
else if (key.downArrow) setSel(i => Math.min(agents.length - 1, i + 1));
else if (input === 'a') { setSyncing(true); setTimeout(() => setSyncing(false), 500); }
else if (key.return && agents[sel]?.detected) { setSyncing(true); setTimeout(() => setSyncing(false), 300); }
});
const detected = agents.filter(a => a.detected).length;
return (
<Box flexDirection="column">
<Text bold color={colors.primary}>SYNC SKILLS</Text>
<Text dimColor>{detected}/{agents.length} agents detected</Text>
{loading && <Text>Detecting agents...</Text>}
{syncing && <Text>Syncing...</Text>}
{!loading && !syncing && (
<Box marginTop={1} flexDirection="column">
{start > 0 && <Text dimColor> ↑ {start} more</Text>}
{visible.map((agent, i) => {
const idx = start + i;
const isSel = idx === sel;
return (
<Text key={agent.type} inverse={isSel} dimColor={!agent.detected}>
{isSel ? symbols.pointer : ' '}{agent.detected ? symbols.checkboxOn : symbols.checkboxOff} {agent.name.padEnd(20)} {agent.detected ? 'Ready' : 'N/A'}
</Text>
);
})}
{start + maxVisible < agents.length && <Text dimColor> ↓ {agents.length - start - maxVisible} more</Text>}
</Box>
)}
<Box marginTop={1}>
<Text dimColor>Enter=sync a=all q=quit</Text>
</Box>
</Box>
);
}
-5
View File
@@ -1,5 +0,0 @@
export { Home } from './Home.js';
export { Browse } from './Browse.js';
export { Installed } from './Installed.js';
export { Sync } from './Sync.js';
export { Settings } from './Settings.js';
-31
View File
@@ -1,31 +0,0 @@
import chalk from 'chalk';
export const colors = {
primary: 'white',
secondary: 'white',
secondaryDim: 'gray',
success: 'white',
danger: 'white',
warning: 'white',
background: 'bgBlack',
borderDim: 'gray',
};
export const symbols = {
pointer: chalk.white('❯'),
bullet: '●',
checkboxOn: chalk.white('✔'),
checkboxOff: chalk.dim('✖'),
check: chalk.white('✓'),
star: '★',
spinner: ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'],
};
export const logo = `
███████╗██╗ ██╗██╗██╗ ██╗ ██╗ ██╗██╗████████╗
██╔════╝██║ ██╔╝██║██║ ██║ ██║ ██╔╝██║╚══██╔══╝
███████╗█████╔╝ ██║██║ ██║ █████╔╝ ██║ ██║
╚════██║██╔═██╗ ██║██║ ██║ ██╔═██╗ ██║ ██║
███████║██║ ██╗██║███████╗███████╗██║ ██╗██║ ██║
╚══════╝╚═╝ ╚═╝╚═╝╚══════╝╚══════╝╚═╝ ╚═╝╚═╝ ╚═╝
`;