meta(aeo): Improve homepage schema and discovery docs
Add visible FAQ and concepts content, strengthen tool-specific integration guides, and publish a dedicated skills-vs-MCP explainer. Extend homepage SEO metadata and JSON-LD so the GitHub Pages catalog better reflects the repository's real positioning and common user questions.
This commit is contained in:
sickn33
50
README.md
50
README.md
@@ -34,9 +34,12 @@ Antigravity Awesome Skills is a GitHub repository and installer CLI for reusable
|
||||
|
||||
- [🚀 New Here? Start Here!](#new-here-start-here)
|
||||
- [📖 Complete Usage Guide](docs/users/usage.md) - **Start here if confused after installation!**
|
||||
- [🧠 Core Concepts](#core-concepts)
|
||||
- [🔌 Compatibility & Invocation](#compatibility--invocation)
|
||||
- [🛠️ Installation](#installation)
|
||||
- [🧭 Integration Guides](#integration-guides)
|
||||
- [🧰 Best Skills By Tool](#best-skills-by-tool)
|
||||
- [❓ Quick FAQ](#quick-faq)
|
||||
- [🛡️ Security Posture](#security-posture)
|
||||
- [🧯 Troubleshooting](#troubleshooting)
|
||||
- [🎁 Curated Collections (Bundles)](#curated-collections)
|
||||
@@ -102,6 +105,53 @@ Once installed, just ask your agent naturally:
|
||||
|
||||
---
|
||||
|
||||
## Core Concepts
|
||||
|
||||
Before you compare bundles or start installing tool-specific paths, it helps to separate four ideas:
|
||||
|
||||
- **Skills**: reusable `SKILL.md` playbooks that teach an AI assistant how to execute a workflow well.
|
||||
- **MCP tools**: integrations and external capabilities the assistant can call. Tools provide actions; skills provide operating instructions.
|
||||
- **Bundles**: curated recommendations for which skills to start with for a role or domain.
|
||||
- **Workflows**: ordered execution playbooks that show how to combine multiple skills step by step.
|
||||
|
||||
If you want the clearest explanation of **skills vs MCP/tools**, start here:
|
||||
|
||||
- [Skills vs MCP Tools](docs/users/skills-vs-mcp-tools.md)
|
||||
- [Bundles](docs/users/bundles.md)
|
||||
- [Workflows](docs/users/workflows.md)
|
||||
|
||||
## Integration Guides
|
||||
|
||||
If your real question is "how do I use Antigravity Awesome Skills with my tool?", use the matching guide:
|
||||
|
||||
- **[Claude Code](docs/users/claude-code-skills.md)**: install paths, starter prompts, plugin marketplace flow, and first-use guidance.
|
||||
- **[Cursor](docs/users/cursor-skills.md)**: chat-first usage, frontend/full-stack starter skills, and practical prompts.
|
||||
- **[Codex CLI](docs/users/codex-cli-skills.md)**: planning, implementation, debugging, testing, and review loops for local coding work.
|
||||
- **[Gemini CLI](docs/users/gemini-cli-skills.md)**: broad engineering, agent systems, integrations, and AI workflow coverage.
|
||||
- **[AI agent skills guide](docs/users/ai-agent-skills.md)**: how to evaluate this repo against broader or narrower alternatives.
|
||||
|
||||
## Quick FAQ
|
||||
|
||||
### What is Antigravity Awesome Skills?
|
||||
|
||||
It is an installable GitHub library of reusable `SKILL.md` playbooks for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and related AI coding assistants.
|
||||
|
||||
### How do I install it?
|
||||
|
||||
Use `npx antigravity-awesome-skills`, or a tool-specific flag like `--codex`, `--cursor`, `--gemini`, or `--claude` when you want the installer to target a specific skills directory.
|
||||
|
||||
### What is the difference between skills and MCP tools?
|
||||
|
||||
Skills are reusable playbooks that tell an AI assistant how to execute a workflow. MCP tools expose external systems or actions the assistant can call. Skills guide behavior; MCP tools provide capabilities.
|
||||
|
||||
### What is the difference between bundles and workflows?
|
||||
|
||||
Bundles are curated sets of recommended skills. Workflows are ordered execution playbooks for concrete outcomes.
|
||||
|
||||
For the expanded version, read [FAQ](docs/users/faq.md).
|
||||
|
||||
---
|
||||
|
||||
## Compatibility & Invocation
|
||||
|
||||
These skills follow the universal **SKILL.md** format and work with any AI coding assistant that supports agentic skills.
|
||||
|
||||
@@ -6,22 +6,22 @@
|
||||
<link rel="icon" type="image/svg+xml" href="%BASE_URL%vite.svg" />
|
||||
<link rel="manifest" href="%BASE_URL%manifest.webmanifest" />
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||||
<meta name="description" content="Discover 1,273+ installable AI skills and launch practical prompts in one place." />
|
||||
<meta name="description" content="Explore 1,326+ installable agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, and Antigravity." />
|
||||
<meta name="author" content="Antigravity Awesome Skills" />
|
||||
<meta property="og:title" content="Antigravity Awesome Skills | 1,273+ installable AI skills catalog" />
|
||||
<meta property="og:description" content="Discover 1,273+ installable AI skills and launch practical prompts in one place." />
|
||||
<meta property="og:title" content="Antigravity Awesome Skills | 1,326+ installable AI skills catalog" />
|
||||
<meta property="og:description" content="Explore 1,326+ installable agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, and Antigravity." />
|
||||
<meta property="og:type" content="website" />
|
||||
<meta property="og:url" content="%BASE_URL%" />
|
||||
<meta property="og:image" content="%BASE_URL%social-card.svg" />
|
||||
<meta name="twitter:title" content="Antigravity Awesome Skills | 1,273+ installable AI skills catalog" />
|
||||
<meta name="twitter:description" content="Discover 1,273+ installable AI skills and launch practical prompts in one place." />
|
||||
<meta name="twitter:title" content="Antigravity Awesome Skills | 1,326+ installable AI skills catalog" />
|
||||
<meta name="twitter:description" content="Explore 1,326+ installable agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, and Antigravity." />
|
||||
<meta name="twitter:image" content="%BASE_URL%social-card.svg" />
|
||||
<meta name="twitter:image:alt" content="Antigravity Awesome Skills catalog preview" />
|
||||
<meta name="robots" content="index, follow" />
|
||||
<meta property="og:site_name" content="Antigravity Awesome Skills" />
|
||||
<meta name="twitter:card" content="summary_large_image" />
|
||||
<meta name="theme-color" content="#0f172a" />
|
||||
<title>Antigravity Awesome Skills | 1,273+ installable AI skills catalog</title>
|
||||
<title>Antigravity Awesome Skills | 1,326+ installable AI skills catalog</title>
|
||||
</head>
|
||||
<body>
|
||||
<div id="root"></div>
|
||||
|
||||
@@ -5,7 +5,49 @@ import { useSkills } from '../context/SkillContext';
|
||||
import { SkillCard } from '../components/SkillCard';
|
||||
import type { SyncMessage, CategoryStats } from '../types';
|
||||
import { usePageMeta } from '../hooks/usePageMeta';
|
||||
import { APP_HOME_CATALOG_COUNT, buildHomeMeta } from '../utils/seo';
|
||||
import { APP_HOME_CATALOG_COUNT, buildHomeMeta, getHomeFaqItems } from '../utils/seo';
|
||||
|
||||
const conceptCards = [
|
||||
{
|
||||
title: 'Skills',
|
||||
body: 'Reusable SKILL.md playbooks that teach an AI assistant how to execute a workflow with better structure and context.',
|
||||
},
|
||||
{
|
||||
title: 'MCP tools',
|
||||
body: 'External capabilities and system integrations the assistant can call. Tools provide actions; skills tell the assistant how to use them well.',
|
||||
},
|
||||
{
|
||||
title: 'Bundles',
|
||||
body: 'Curated starting sets of recommended skills for a role, domain, or team that wants a smaller shortlist first.',
|
||||
},
|
||||
{
|
||||
title: 'Workflows',
|
||||
body: 'Ordered execution playbooks that show how to combine multiple skills step by step for a concrete outcome.',
|
||||
},
|
||||
] as const;
|
||||
|
||||
const integrationGuides = [
|
||||
{
|
||||
name: 'Claude Code',
|
||||
href: 'https://github.com/sickn33/antigravity-awesome-skills/blob/main/docs/users/claude-code-skills.md',
|
||||
body: 'Install paths, starter prompts, plugin marketplace flow, and first skills to try.',
|
||||
},
|
||||
{
|
||||
name: 'Cursor',
|
||||
href: 'https://github.com/sickn33/antigravity-awesome-skills/blob/main/docs/users/cursor-skills.md',
|
||||
body: 'A practical guide for chat-first UI, frontend, and full-stack workflows in Cursor.',
|
||||
},
|
||||
{
|
||||
name: 'Codex CLI',
|
||||
href: 'https://github.com/sickn33/antigravity-awesome-skills/blob/main/docs/users/codex-cli-skills.md',
|
||||
body: 'How to use Antigravity Awesome Skills with Codex CLI for planning, implementation, testing, and review.',
|
||||
},
|
||||
{
|
||||
name: 'Gemini CLI',
|
||||
href: 'https://github.com/sickn33/antigravity-awesome-skills/blob/main/docs/users/gemini-cli-skills.md',
|
||||
body: 'A broad starting point for engineering, agent systems, integrations, and applied AI workflows.',
|
||||
},
|
||||
] as const;
|
||||
|
||||
export function Home(): React.ReactElement {
|
||||
const { skills, stars, loading, error, refreshSkills } = useSkills();
|
||||
@@ -19,6 +61,7 @@ export function Home(): React.ReactElement {
|
||||
const installCommand = 'npx antigravity-awesome-skills';
|
||||
const docsLink = 'https://github.com/sickn33/antigravity-awesome-skills/blob/main/docs/users/usage.md';
|
||||
const installLink = 'https://www.npmjs.com/package/antigravity-awesome-skills';
|
||||
const faqItems = getHomeFaqItems();
|
||||
|
||||
usePageMeta(buildHomeMeta(skills.length));
|
||||
|
||||
@@ -262,6 +305,110 @@ export function Home(): React.ReactElement {
|
||||
/>
|
||||
)}
|
||||
</div>
|
||||
|
||||
<div className="mt-12 space-y-10">
|
||||
<section className="rounded-xl border border-slate-200 dark:border-slate-800 bg-white dark:bg-slate-900 p-6 sm:p-7 shadow-sm">
|
||||
<p className="text-xs font-semibold uppercase tracking-wide text-slate-500 dark:text-slate-400 mb-3">
|
||||
Concepts
|
||||
</p>
|
||||
<h2 className="text-2xl font-bold tracking-tight text-slate-900 dark:text-slate-100">
|
||||
Understand the moving pieces before you install everything
|
||||
</h2>
|
||||
<p className="mt-3 max-w-4xl text-sm sm:text-base leading-relaxed text-slate-600 dark:text-slate-300">
|
||||
The catalog is easier to navigate once you separate reusable playbooks from external tool integrations.
|
||||
Skills explain how to execute a workflow well, MCP tools expose external systems, bundles narrow the
|
||||
starting set, and workflows show the order of operations.
|
||||
</p>
|
||||
<div className="mt-6 grid gap-4 md:grid-cols-2 xl:grid-cols-4">
|
||||
{conceptCards.map((card) => (
|
||||
<article
|
||||
key={card.title}
|
||||
className="rounded-xl border border-slate-200 dark:border-slate-800 bg-slate-50 dark:bg-slate-950 p-4"
|
||||
>
|
||||
<h3 className="text-base font-semibold text-slate-900 dark:text-slate-100">{card.title}</h3>
|
||||
<p className="mt-2 text-sm leading-relaxed text-slate-600 dark:text-slate-300">{card.body}</p>
|
||||
</article>
|
||||
))}
|
||||
</div>
|
||||
<div className="mt-5 flex flex-wrap gap-3">
|
||||
<a
|
||||
href="https://github.com/sickn33/antigravity-awesome-skills/blob/main/docs/users/skills-vs-mcp-tools.md"
|
||||
target="_blank"
|
||||
rel="noreferrer"
|
||||
className="inline-flex items-center justify-center rounded-lg border border-slate-200 dark:border-slate-700 px-4 py-2.5 text-sm font-semibold text-slate-700 dark:text-slate-200 hover:bg-slate-50 dark:hover:bg-slate-800"
|
||||
>
|
||||
Read skills vs MCP/tools
|
||||
</a>
|
||||
<a
|
||||
href="https://github.com/sickn33/antigravity-awesome-skills/blob/main/docs/users/bundles.md"
|
||||
target="_blank"
|
||||
rel="noreferrer"
|
||||
className="inline-flex items-center justify-center rounded-lg border border-slate-200 dark:border-slate-700 px-4 py-2.5 text-sm font-semibold text-slate-700 dark:text-slate-200 hover:bg-slate-50 dark:hover:bg-slate-800"
|
||||
>
|
||||
Browse bundles
|
||||
</a>
|
||||
<a
|
||||
href="https://github.com/sickn33/antigravity-awesome-skills/blob/main/docs/users/workflows.md"
|
||||
target="_blank"
|
||||
rel="noreferrer"
|
||||
className="inline-flex items-center justify-center rounded-lg border border-slate-200 dark:border-slate-700 px-4 py-2.5 text-sm font-semibold text-slate-700 dark:text-slate-200 hover:bg-slate-50 dark:hover:bg-slate-800"
|
||||
>
|
||||
Explore workflows
|
||||
</a>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<section className="rounded-xl border border-slate-200 dark:border-slate-800 bg-white dark:bg-slate-900 p-6 sm:p-7 shadow-sm">
|
||||
<p className="text-xs font-semibold uppercase tracking-wide text-slate-500 dark:text-slate-400 mb-3">
|
||||
Integration Guides
|
||||
</p>
|
||||
<h2 className="text-2xl font-bold tracking-tight text-slate-900 dark:text-slate-100">
|
||||
Start from the guide that matches your AI assistant
|
||||
</h2>
|
||||
<div className="mt-6 grid gap-4 md:grid-cols-2">
|
||||
{integrationGuides.map((guide) => (
|
||||
<a
|
||||
key={guide.name}
|
||||
href={guide.href}
|
||||
target="_blank"
|
||||
rel="noreferrer"
|
||||
className="rounded-xl border border-slate-200 dark:border-slate-800 bg-slate-50 dark:bg-slate-950 p-4 transition-colors hover:border-indigo-300 dark:hover:border-indigo-700"
|
||||
>
|
||||
<h3 className="text-base font-semibold text-slate-900 dark:text-slate-100">{guide.name}</h3>
|
||||
<p className="mt-2 text-sm leading-relaxed text-slate-600 dark:text-slate-300">{guide.body}</p>
|
||||
</a>
|
||||
))}
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<section className="rounded-xl border border-slate-200 dark:border-slate-800 bg-white dark:bg-slate-900 p-6 sm:p-7 shadow-sm">
|
||||
<p className="text-xs font-semibold uppercase tracking-wide text-slate-500 dark:text-slate-400 mb-3">
|
||||
Quick FAQ
|
||||
</p>
|
||||
<h2 className="text-2xl font-bold tracking-tight text-slate-900 dark:text-slate-100">
|
||||
Answers to the first questions most users ask
|
||||
</h2>
|
||||
<div className="mt-6 grid gap-4 lg:grid-cols-2">
|
||||
{faqItems.map((item) => (
|
||||
<article
|
||||
key={item.question}
|
||||
className="rounded-xl border border-slate-200 dark:border-slate-800 bg-slate-50 dark:bg-slate-950 p-4"
|
||||
>
|
||||
<h3 className="text-base font-semibold text-slate-900 dark:text-slate-100">{item.question}</h3>
|
||||
<p className="mt-2 text-sm leading-relaxed text-slate-600 dark:text-slate-300">{item.answer}</p>
|
||||
</article>
|
||||
))}
|
||||
</div>
|
||||
<a
|
||||
href="https://github.com/sickn33/antigravity-awesome-skills/blob/main/docs/users/faq.md"
|
||||
target="_blank"
|
||||
rel="noreferrer"
|
||||
className="mt-5 inline-flex items-center justify-center rounded-lg border border-slate-200 dark:border-slate-700 px-4 py-2.5 text-sm font-semibold text-slate-700 dark:text-slate-200 hover:bg-slate-50 dark:hover:bg-slate-800"
|
||||
>
|
||||
Read the full FAQ
|
||||
</a>
|
||||
</section>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
@@ -89,7 +89,8 @@ describe('Home', () => {
|
||||
});
|
||||
|
||||
expect(screen.getByRole('button', { name: /Copy install command/i })).toBeInTheDocument();
|
||||
expect(screen.getByText(/npx antigravity-awesome-skills/i)).toBeInTheDocument();
|
||||
expect(screen.getAllByText(/npx antigravity-awesome-skills/i).length).toBeGreaterThan(0);
|
||||
expect(screen.getByText(/What is the difference between skills and MCP tools/i)).toBeInTheDocument();
|
||||
expect(document.querySelector('meta[property="og:title"]')).toHaveAttribute(
|
||||
'content',
|
||||
expect.stringContaining('Antigravity Awesome Skills'),
|
||||
|
||||
@@ -28,8 +28,8 @@ describe('SEO helpers', () => {
|
||||
it('builds homepage metadata with the canonical catalog message', () => {
|
||||
const meta = buildHomeMeta(10);
|
||||
|
||||
expect(meta.title).toContain('1,273+');
|
||||
expect(meta.description).toContain('1273+ installable agentic skills');
|
||||
expect(meta.title).toContain('1,326+');
|
||||
expect(meta.description).toContain('1,326+ installable agentic skills');
|
||||
expect(meta.canonicalPath).toBe('/');
|
||||
expect(meta.ogTitle).toBe(meta.title);
|
||||
expect(meta.ogImage).toBe(DEFAULT_SOCIAL_IMAGE);
|
||||
|
||||
@@ -1,9 +1,31 @@
|
||||
import type { SeoJsonLdValue, SeoMeta, TwitterCard, Skill } from '../types';
|
||||
|
||||
export const APP_HOME_CATALOG_COUNT = 1273;
|
||||
export const APP_HOME_CATALOG_COUNT = 1326;
|
||||
export const DEFAULT_TOP_SKILL_COUNT = 40;
|
||||
export const DEFAULT_SOCIAL_IMAGE = 'social-card.svg';
|
||||
const SITE_NAME = 'Antigravity Awesome Skills';
|
||||
const FAQ_ITEMS = [
|
||||
{
|
||||
question: 'What is Antigravity Awesome Skills?',
|
||||
answer:
|
||||
'Antigravity Awesome Skills is an installable GitHub library of reusable SKILL.md playbooks for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and related AI coding assistants.',
|
||||
},
|
||||
{
|
||||
question: 'How do I install Antigravity Awesome Skills?',
|
||||
answer:
|
||||
'Install the library with npx antigravity-awesome-skills, then use tool-specific flags such as --codex, --cursor, --gemini, or --claude when you want the installer to target a specific skills directory.',
|
||||
},
|
||||
{
|
||||
question: 'What is the difference between skills and MCP tools?',
|
||||
answer:
|
||||
'Skills are reusable playbooks that tell an AI assistant how to execute a workflow, while MCP tools expose external systems or actions the assistant can call. Skills guide behavior; MCP tools provide capabilities.',
|
||||
},
|
||||
{
|
||||
question: 'What is the difference between bundles and workflows?',
|
||||
answer:
|
||||
'Bundles are curated sets of recommended skills for a role or domain, while workflows are ordered execution playbooks that show how to combine skills step by step for a concrete outcome.',
|
||||
},
|
||||
] as const;
|
||||
|
||||
export function toCanonicalPath(pathname: string): string {
|
||||
if (!pathname || pathname === '/') {
|
||||
@@ -70,6 +92,44 @@ function buildWebSiteSchema(canonicalUrl: string): Record<string, unknown> {
|
||||
};
|
||||
}
|
||||
|
||||
function buildSoftwareSourceCodeSchema(canonicalUrl: string, visibleCount: number): Record<string, unknown> {
|
||||
const visibleCountLabel = `${visibleCount.toLocaleString('en-US')}+`;
|
||||
return {
|
||||
'@context': 'https://schema.org',
|
||||
'@type': 'SoftwareSourceCode',
|
||||
name: SITE_NAME,
|
||||
description: `Installable GitHub library of ${visibleCountLabel} agentic skills for AI coding assistants.`,
|
||||
url: canonicalUrl,
|
||||
codeRepository: 'https://github.com/sickn33/antigravity-awesome-skills',
|
||||
programmingLanguage: {
|
||||
'@type': 'ComputerLanguage',
|
||||
name: 'Markdown',
|
||||
url: 'https://en.wikipedia.org/wiki/Markdown',
|
||||
},
|
||||
license: 'https://github.com/sickn33/antigravity-awesome-skills/blob/main/LICENSE',
|
||||
};
|
||||
}
|
||||
|
||||
function buildHomeFaqSchema(canonicalUrl: string): Record<string, unknown> {
|
||||
return {
|
||||
'@context': 'https://schema.org',
|
||||
'@type': 'FAQPage',
|
||||
url: canonicalUrl,
|
||||
mainEntity: FAQ_ITEMS.map((item) => ({
|
||||
'@type': 'Question',
|
||||
name: item.question,
|
||||
acceptedAnswer: {
|
||||
'@type': 'Answer',
|
||||
text: item.answer,
|
||||
},
|
||||
})),
|
||||
};
|
||||
}
|
||||
|
||||
export function getHomeFaqItems(): Array<{ question: string; answer: string }> {
|
||||
return [...FAQ_ITEMS];
|
||||
}
|
||||
|
||||
function ensureMetaTag(name: string, content: string, attributeName: 'name' | 'property'): void {
|
||||
const selector = `meta[${attributeName}="${name}"]`;
|
||||
let tag = document.querySelector(selector) as HTMLMetaElement | null;
|
||||
@@ -216,8 +276,9 @@ export function isTopSkill(skillId: string, skills: ReadonlyArray<Skill>, limit
|
||||
|
||||
export function buildHomeMeta(skillCount: number): SeoMeta {
|
||||
const visibleCount = Math.max(skillCount, APP_HOME_CATALOG_COUNT);
|
||||
const title = 'Antigravity Awesome Skills | 1,273+ installable AI skills catalog';
|
||||
const description = `Explore ${visibleCount}+ installable agentic skills and prompt templates. Discover what fits your workflow, copy prompts fast, and launch AI-powered actions with confidence.`;
|
||||
const visibleCountLabel = `${visibleCount.toLocaleString('en-US')}+`;
|
||||
const title = `Antigravity Awesome Skills | ${visibleCountLabel} installable AI skills catalog`;
|
||||
const description = `Explore ${visibleCountLabel} installable agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, and Antigravity. Browse bundles, workflows, FAQs, and integration guides in one place.`;
|
||||
return {
|
||||
title,
|
||||
description,
|
||||
@@ -241,6 +302,8 @@ export function buildHomeMeta(skillCount: number): SeoMeta {
|
||||
},
|
||||
buildOrganizationSchema(),
|
||||
buildWebSiteSchema(canonicalUrl),
|
||||
buildSoftwareSourceCodeSchema(canonicalUrl, visibleCount),
|
||||
buildHomeFaqSchema(canonicalUrl),
|
||||
],
|
||||
};
|
||||
}
|
||||
|
||||
@@ -4,6 +4,10 @@ If you are looking for **Claude Code skills** you can install from GitHub, this
|
||||
|
||||
Antigravity Awesome Skills gives Claude Code users an installable library of `SKILL.md` playbooks, role-based bundles, and execution workflows. The goal is not just to collect prompts, but to make repeatable engineering tasks easier to invoke, review, and reuse.
|
||||
|
||||
## How to use Antigravity Awesome Skills with Claude Code
|
||||
|
||||
Install the library into Claude Code, then invoke focused skills directly in the conversation or through the plugin marketplace path. Claude Code benefits most when you keep the prompt specific about the skill, the scope, and the intended output.
|
||||
|
||||
## Why use this repo for Claude Code
|
||||
|
||||
- It includes 1,326+ skills instead of a narrow single-domain starter pack.
|
||||
|
||||
@@ -4,6 +4,14 @@ If you want **Codex CLI skills** that are easy to install and practical in a loc
|
||||
|
||||
Antigravity Awesome Skills supports Codex CLI through the `.codex/skills/` path and gives you a wide set of reusable task playbooks for planning, implementation, debugging, testing, security review, and delivery.
|
||||
|
||||
## How to use Antigravity Awesome Skills with Codex CLI
|
||||
|
||||
Install the library into your Codex path, then invoke focused skills directly in your prompt. The most common pattern is:
|
||||
|
||||
1. install with `npx antigravity-awesome-skills --codex`
|
||||
2. choose one workflow-oriented skill such as `@brainstorming`, `@concise-planning`, or `@test-driven-development`
|
||||
3. ask Codex to apply that skill to a concrete file, feature, test, or bugfix
|
||||
|
||||
## Why use this repo for Codex CLI
|
||||
|
||||
- It supports Codex CLI with a dedicated install flag and a standard skills layout.
|
||||
|
||||
@@ -4,6 +4,10 @@ If you searched for **Cursor skills** on GitHub, this repository is built to be
|
||||
|
||||
Antigravity Awesome Skills supports Cursor through the `.cursor/skills/` path and keeps the entry point simple: install once, then invoke the skills you need in chat.
|
||||
|
||||
## How to use Antigravity Awesome Skills with Cursor
|
||||
|
||||
Install the library into Cursor's skills directory, then call skills directly in chat with `@skill-name`. Cursor works especially well when you combine planning, implementation, and validation skills inside one conversation.
|
||||
|
||||
## Why use this repo for Cursor
|
||||
|
||||
- It supports Cursor directly with a dedicated install flag.
|
||||
|
||||
@@ -29,6 +29,15 @@ Start from:
|
||||
- [bundles.md](bundles.md)
|
||||
- [workflows.md](workflows.md)
|
||||
|
||||
### What is the difference between skills and MCP tools?
|
||||
|
||||
- **Skills** are reusable `SKILL.md` playbooks that guide an AI assistant through a workflow.
|
||||
- **MCP tools** are integrations or callable capabilities that let the assistant interact with external systems.
|
||||
|
||||
Use skills when you want better process, structure, and execution quality. Use MCP tools when you need access to APIs, services, databases, or other systems. Use both when you want reliable workflows plus external capabilities.
|
||||
|
||||
For the longer explanation, read [skills-vs-mcp-tools.md](skills-vs-mcp-tools.md).
|
||||
|
||||
### Which AI tools work with these skills?
|
||||
|
||||
- ✅ **Claude Code** (Anthropic CLI)
|
||||
|
||||
@@ -4,6 +4,10 @@ If you are evaluating **Gemini CLI skills** on GitHub, this repository is a stro
|
||||
|
||||
Antigravity Awesome Skills supports Gemini CLI through the `.gemini/skills/` path and combines general engineering playbooks with specialized skills for AI systems, integrations, infrastructure, testing, product, and growth.
|
||||
|
||||
## How to use Antigravity Awesome Skills with Gemini CLI
|
||||
|
||||
Install into the Gemini skills path, then ask Gemini to apply one skill at a time to a specific task. This works best when you keep the active set small and choose a clear workflow-oriented skill for the job in front of you.
|
||||
|
||||
## Why use this repo for Gemini CLI
|
||||
|
||||
- It installs directly into the expected Gemini skills path.
|
||||
|
||||
89
docs/users/skills-vs-mcp-tools.md
Normal file
89
docs/users/skills-vs-mcp-tools.md
Normal file
@@ -0,0 +1,89 @@
|
||||
# Skills vs MCP Tools
|
||||
|
||||
If you are trying to understand the difference between **Antigravity skills** and **MCP tools**, the short version is:
|
||||
|
||||
- **Skills** are reusable `SKILL.md` playbooks that tell an AI assistant how to execute a workflow.
|
||||
- **MCP tools** are integrations or callable capabilities that let the assistant interact with external systems.
|
||||
|
||||
The two are complementary, not competing.
|
||||
|
||||
## What a skill does
|
||||
|
||||
A skill gives the model better instructions for a repeated task such as:
|
||||
|
||||
- planning a feature
|
||||
- reviewing code
|
||||
- running a security audit
|
||||
- writing a README
|
||||
- debugging a failing test suite
|
||||
|
||||
In practice, a skill improves the assistant's decision-making, structure, and process for a task.
|
||||
|
||||
Example:
|
||||
|
||||
- `@brainstorming` helps the model clarify requirements before implementation.
|
||||
- `@lint-and-validate` helps the model run the right quality checks before claiming success.
|
||||
|
||||
## What an MCP tool does
|
||||
|
||||
An MCP tool gives the model a capability it would not otherwise have, such as:
|
||||
|
||||
- reading from a database
|
||||
- calling GitHub APIs
|
||||
- fetching docs from a service
|
||||
- creating calendar events
|
||||
- querying an external system
|
||||
|
||||
In practice, an MCP tool expands what the assistant can do in the world.
|
||||
|
||||
## The easiest mental model
|
||||
|
||||
Use this rule:
|
||||
|
||||
- **Skills tell the assistant how to work.**
|
||||
- **MCP tools tell the assistant what systems it can touch.**
|
||||
|
||||
If you only install tools, the assistant may have access but still behave inconsistently.
|
||||
|
||||
If you only install skills, the assistant may know the workflow but still lack the capability to reach the external system it needs.
|
||||
|
||||
Together, they are much stronger.
|
||||
|
||||
## Which one should you start with?
|
||||
|
||||
Start with **skills** if:
|
||||
|
||||
- you want better planning, coding, debugging, testing, or review behavior immediately
|
||||
- you are working mostly in local files and terminal flows
|
||||
- you want reusable playbooks before adding more integrations
|
||||
|
||||
Start with **MCP tools** if:
|
||||
|
||||
- your main blocker is access to external systems
|
||||
- you need the model to call APIs, query services, or interact with hosted platforms
|
||||
- you already like the model's workflow quality, but need more reach
|
||||
|
||||
Use **both** when:
|
||||
|
||||
- you want reliable workflows plus external capabilities
|
||||
- you are building agent systems, internal tooling, or multi-step operational flows
|
||||
|
||||
## How this repo fits in
|
||||
|
||||
Antigravity Awesome Skills is primarily a **skill library**:
|
||||
|
||||
- installable `SKILL.md` playbooks
|
||||
- bundles for role-based starting points
|
||||
- workflows for ordered execution patterns
|
||||
- tool-specific guides for Claude Code, Cursor, Codex CLI, Gemini CLI, and others
|
||||
|
||||
Many skills in this repo also explain how to work with MCP, APIs, and other integrations, but the repository itself is centered on reusable workflow guidance rather than acting as an MCP server.
|
||||
|
||||
## Good next reads
|
||||
|
||||
- [FAQ](faq.md)
|
||||
- [Bundles](bundles.md)
|
||||
- [Workflows](workflows.md)
|
||||
- [AI Agent Skills](ai-agent-skills.md)
|
||||
- [Codex CLI Skills](codex-cli-skills.md)
|
||||
- [Gemini CLI Skills](gemini-cli-skills.md)
|
||||
Reference in New Issue
Block a user