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 npx command-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.
  • Download Git
• Python (optional but recommended): Many advanced skills and their accompanying scripts are written in Python.
  • Download 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.

1. Run the npx command: Open your terminal or command prompt and execute:

   npx antigravity-awesome-skills
   

   This 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.

2. Follow On-Screen Prompts: The npx interface 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.

1. Install the package globally:

   Using npm:

   npm install -g antigravity-awesome-skills
   

   Using yarn:

   yarn global add antigravity-awesome-skills
   

2. Verify Installation: After installation, you should be able to run the antigravity-awesome-skills command directly from your terminal:

   antigravity-awesome-skills --help
   

   This 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.

1. Clone the repository:

   git clone https://github.com/sickn33/antigravity-awesome-skills.git
   cd antigravity-awesome-skills
   

2. 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.txt
   

   Note: Many skills within the plugins/ directory are self-contained markdown files (SKILL.md) that don't require npm install for 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.

1. Identify required environment variables: Consult the documentation for specific skills you plan to use. Often, the SKILL.md file or accompanying scripts will mention necessary variables (e.g., CLAUDE_API_KEY, INSTAGRAM_ACCESS_TOKEN).

2. Method 1: Using a .env file (Recommended for local development) Create a file named .env in 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 skills
   

   Tools often automatically load variables from a .env file. If not, you might need a utility like dotenv (Python) or load-dotenv (Node.js).

3. 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-skill
   

   Note: 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.