Installation & Setup
Installation & Setup
This section provides detailed instructions on how to install and set up Antigravity Awesome Skills for use with your preferred AI coding assistant. You'll find guidance for quick starts, persistent installations, and development setups, along with essential environment variable configurations.
Prerequisites
Before you begin, ensure you have the following installed on your system:
- Node.js & npm (or yarn): Required for using the
npxcommand-line utility and for managing JavaScript dependencies if you're developing or running the web app.- Download Node.js (includes npm)
- Git: Required if you plan to clone the repository for development or to access specific skill files.
- Python (optional but recommended): Many advanced skills and their accompanying scripts are written in Python.
Quick Start: Using NPX (Recommended)
The fastest way to try out Antigravity Awesome Skills is by using npx. This command downloads and executes the package without a persistent local installation, making it ideal for one-off uses or testing.
-
Run the
npxcommand: Open your terminal or command prompt and execute:npx antigravity-awesome-skillsThis command will launch an interactive session or display the main menu for the skill library, allowing you to browse, search, and potentially execute skills directly.
-
Follow On-Screen Prompts: The
npxinterface will guide you through selecting and using skills.
Persistent Installation: npm or Yarn
For a more permanent installation that allows you to easily update and manage the library, install it globally using npm or yarn.
-
Install the package globally:
Using npm:
npm install -g antigravity-awesome-skillsUsing yarn:
yarn global add antigravity-awesome-skills -
Verify Installation: After installation, you should be able to run the
antigravity-awesome-skillscommand directly from your terminal:antigravity-awesome-skills --helpThis will display available commands and options, confirming the installation.
Cloning the GitHub Repository (For Development & Full Access)
If you intend to contribute to the project, customize skills, or access the full source code, cloning the repository is the way to go.
-
Clone the repository:
git clone https://github.com/sickn33/antigravity-awesome-skills.git cd antigravity-awesome-skills -
Install dependencies (if running the web app or tools): The repository contains various components, including a web application for browsing skills (
apps/web-app) and various plugins. If you plan to work with these, install their respective dependencies:# Install root dependencies (for general tools or if required by specific plugins) npm install # If you intend to run the web-app cd apps/web-app npm install npm run dev # To start the development server cd ../.. # For Python-based skills that have their own requirements (e.g., in plugins/) # Navigate to the specific skill directory and install its requirements. # Example for a skill with a requirements.txt: # cd plugins/antigravity-awesome-skills-claude/skills/instagram/ # pip install -r requirements.txtNote: Many skills within the
plugins/directory are self-contained markdown files (SKILL.md) that don't requirenpm installfor their basic usage, but might rely on Python scripts or other tools that have their own dependencies.
Setting up Environment Variables
Many skills, especially those interacting with third-party APIs (e.g., Claude, Gemini, Instagram), require API keys or other configuration details. These are best managed using environment variables to avoid hardcoding sensitive information.
-
Identify required environment variables: Consult the documentation for specific skills you plan to use. Often, the
SKILL.mdfile or accompanying scripts will mention necessary variables (e.g.,CLAUDE_API_KEY,INSTAGRAM_ACCESS_TOKEN). -
Method 1: Using a
.envfile (Recommended for local development) Create a file named.envin the root directory of your project (or in the directory where the skill script is run) and add your variables:# .env example CLAUDE_API_KEY="sk-your-claude-api-key" INSTAGRAM_ACCESS_TOKEN="your-instagram-long-lived-token" # ... other variables for specific skillsTools often automatically load variables from a
.envfile. If not, you might need a utility likedotenv(Python) orload-dotenv(Node.js). -
Method 2: Exporting in your shell (Temporary or for CI/CD) For temporary use in your current terminal session, or in CI/CD pipelines, you can export variables:
export CLAUDE_API_KEY="sk-your-claude-api-key" export INSTAGRAM_ACCESS_TOKEN="your-instagram-long-lived-token" # Then run your skill or agent antigravity-awesome-skills run some-skillNote: Variables set this way are only active for the current shell session and its child processes.
Next Steps
Once installed, you're ready to explore the vast catalog of skills:
- Choose Your Tool: Understand how to integrate Antigravity Awesome Skills with your specific AI coding assistant (e.g., Claude Code, Cursor, Gemini CLI).
- Browse 1,470+ Skills: Discover the full range of available skills and their functionalities.
- Bundles: Get started with curated collections of skills for specific roles or tasks.
- Workflows: Learn how to chain multiple skills together for complex operations.