#!/usr/bin/env node
const { spawnSync } = require("child_process");
const path = require("path");
const fs = require("fs");
const os = require("os");
const REPO = "https://github.com/sickn33/antigravity-awesome-skills.git";
const HOME = process.env.HOME || process.env.USERPROFILE || "";
function resolveDir(p) {
if (!p) return null;
const s = p.replace(/^~($|\/)/, HOME + "$1");
return path.resolve(s);
}
function parseArgs() {
const a = process.argv.slice(2);
let pathArg = null;
let versionArg = null;
let tagArg = null;
let cursor = false,
claude = false,
gemini = false,
codex = false,
antigravity = false,
kiro = false;
for (let i = 0; i < a.length; i++) {
if (a[i] === "--help" || a[i] === "-h") return { help: true };
if (a[i] === "--path" && a[i + 1]) {
pathArg = a[++i];
continue;
}
if (a[i] === "--version" && a[i + 1]) {
versionArg = a[++i];
continue;
}
if (a[i] === "--tag" && a[i + 1]) {
tagArg = a[++i];
continue;
}
if (a[i] === "--cursor") {
cursor = true;
continue;
}
if (a[i] === "--claude") {
claude = true;
continue;
}
if (a[i] === "--gemini") {
gemini = true;
continue;
}
if (a[i] === "--codex") {
codex = true;
continue;
}
if (a[i] === "--antigravity") {
antigravity = true;
continue;
}
if (a[i] === "--kiro") {
kiro = true;
continue;
}
if (a[i] === "install") continue;
}
return {
pathArg,
versionArg,
tagArg,
cursor,
claude,
gemini,
codex,
antigravity,
kiro,
};
}
function defaultDir(opts) {
if (opts.pathArg) return resolveDir(opts.pathArg);
if (opts.cursor) return path.join(HOME, ".cursor", "skills");
if (opts.claude) return path.join(HOME, ".claude", "skills");
if (opts.gemini) return path.join(HOME, ".gemini", "skills");
if (opts.codex) {
const codexHome = process.env.CODEX_HOME;
if (codexHome) return path.join(codexHome, "skills");
return path.join(HOME, ".codex", "skills");
}
if (opts.kiro) return path.join(HOME, ".kiro", "skills");
if (opts.antigravity)
return path.join(HOME, ".gemini", "antigravity", "skills");
return path.join(HOME, ".gemini", "antigravity", "skills");
}
function printHelp() {
console.log(`
antigravity-awesome-skills — installer
npx antigravity-awesome-skills [install] [options]
Clones the skills repo into your agent's skills directory.
Options:
--cursor Install to ~/.cursor/skills (Cursor)
--claude Install to ~/.claude/skills (Claude Code)
--gemini Install to ~/.gemini/skills (Gemini CLI)
--codex Install to ~/.codex/skills (Codex CLI)
--kiro Install to ~/.kiro/skills (Kiro CLI)
--antigravity Install to ~/.gemini/antigravity/skills (Antigravity)
--path
Install to (default: ~/.gemini/antigravity/skills)
--version After clone, checkout tag v (e.g. 4.6.0 -> v4.6.0)
--tag After clone, checkout this tag (e.g. v4.6.0)
Examples:
npx antigravity-awesome-skills
npx antigravity-awesome-skills --cursor
npx antigravity-awesome-skills --kiro
npx antigravity-awesome-skills --antigravity
npx antigravity-awesome-skills --version 4.6.0
npx antigravity-awesome-skills --path ./my-skills
`);
}
function copyRecursiveSync(src, dest, skipGit = true) {
const stats = fs.statSync(src);
if (stats.isDirectory()) {
if (!fs.existsSync(dest)) {
fs.mkdirSync(dest, { recursive: true });
}
fs.readdirSync(src).forEach((child) => {
if (skipGit && child === ".git") return;
copyRecursiveSync(path.join(src, child), path.join(dest, child), skipGit);
});
} else {
fs.copyFileSync(src, dest);
}
}
/** Copy contents of repo's skills/ into target so each skill is target/skill-name/ (for Claude Code etc.). */
function installSkillsIntoTarget(tempDir, target) {
const repoSkills = path.join(tempDir, "skills");
if (!fs.existsSync(repoSkills)) {
console.error("Cloned repo has no skills/ directory.");
process.exit(1);
}
fs.readdirSync(repoSkills).forEach((name) => {
const src = path.join(repoSkills, name);
const dest = path.join(target, name);
copyRecursiveSync(src, dest);
});
const repoDocs = path.join(tempDir, "docs");
if (fs.existsSync(repoDocs)) {
const docsDest = path.join(target, "docs");
if (!fs.existsSync(docsDest)) fs.mkdirSync(docsDest, { recursive: true });
copyRecursiveSync(repoDocs, docsDest);
}
}
function run(cmd, args, opts = {}) {
const r = spawnSync(cmd, args, { stdio: "inherit", ...opts });
if (r.status !== 0) process.exit(r.status == null ? 1 : r.status);
}
function main() {
const opts = parseArgs();
const { tagArg, versionArg } = opts;
if (opts.help) {
printHelp();
return;
}
const target = defaultDir(opts);
if (!target || !HOME) {
console.error(
"Could not resolve home directory. Use --path .",
);
process.exit(1);
}
const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "ag-skills-"));
const originalCwd = process.cwd();
try {
if (process.platform === "win32") {
run("git", ["-c", "core.symlinks=true", "clone", REPO, tempDir]);
} else {
run("git", ["clone", REPO, tempDir]);
}
const ref =
tagArg ||
(versionArg
? versionArg.startsWith("v")
? versionArg
: `v${versionArg}`
: null);
if (ref) {
console.log(`Checking out ${ref}…`);
process.chdir(tempDir);
run("git", ["checkout", ref]);
process.chdir(originalCwd);
}
if (fs.existsSync(target)) {
const gitDir = path.join(target, ".git");
if (fs.existsSync(gitDir)) {
console.log("Migrating from full-repo install to skills-only layout…");
const entries = fs.readdirSync(target);
for (const name of entries) {
const full = path.join(target, name);
const stat = fs.statSync(full);
if (stat.isDirectory()) {
if (fs.rmSync) {
fs.rmSync(full, { recursive: true, force: true });
} else {
fs.rmdirSync(full, { recursive: true });
}
} else {
fs.unlinkSync(full);
}
}
} else {
console.log(`Updating existing install at ${target}…`);
}
} else {
const parent = path.dirname(target);
if (!fs.existsSync(parent)) {
try {
fs.mkdirSync(parent, { recursive: true });
} catch (e) {
console.error(`Cannot create parent directory: ${parent}`, e.message);
process.exit(1);
}
}
fs.mkdirSync(target, { recursive: true });
}
installSkillsIntoTarget(tempDir, target);
console.log(`\nInstalled to ${target}`);
console.log(
"Pick a bundle in docs/BUNDLES.md and use @skill-name in your AI assistant.",
);
} finally {
try {
if (fs.existsSync(tempDir)) {
if (fs.rmSync) {
fs.rmSync(tempDir, { recursive: true, force: true });
} else {
fs.rmdirSync(tempDir, { recursive: true });
}
}
} catch (e) {
// ignore cleanup errors
}
}
}
main();