# Public API Skills

Real-time data skills. Free. No keys. Token-efficient.

> **CRITICAL**: Use this ONLY as a Gemini Extension. DO NOT add this to your MCP server settings. If you previously added `public-api-toolkit` to your MCP configuration, please remove it to avoid confusion.

## Install

```bash
gemini extensions install https://github.com/nikhilreddy3888/public-api-toolkit
```

## Activate Skill

```bash
gemini activate_skill <skill-name>
```

## Mandates

- **Explain Before Acting**: You MUST provide a concise, one-sentence explanation of your intent immediately before executing a skill call.
- **Pure Skill Pack**: All capabilities are provided as Markdown-based skills. No local execution or server is required.

## Skills (43)

| # | Skill | Use |
|---|-------|-----|
| 1 | weather | forecasts, current weather |
| 2 | crypto | BTC, ETH, crypto prices |
| 3 | currency | FX rates, currency conversion |
| 4 | wikipedia | topic summaries |
| 5 | geocoding | address → coordinates |
| 6 | ip_geolocation | IP → location |
| 7 | country_data | country profiles |
| 8 | dictionary | word definitions |
| 9 | books | book search |
| 10 | translation | text translation |
| 11 | news | space/science news |
| 12 | images | placeholder images |
| 13 | movie_tv_data | TV/movies |
| 14 | food_recipes | recipes, meals |
| 15 | math | calculations |
| 16 | space | ISS, NASA images |
| 17 | holidays | public holidays |
| 18 | transport | flights, bikes |
| 19 | random_facts | jokes, quotes |
| 20 | animals | animal facts |
| 21 | name_insights | name analysis |
| 22 | security_intel | CVE, vulnerabilities |
| 23 | job_search | job listings |
| 24 | air_quality | AQI data |
| 25 | http_utils | HTTP tools |
| 26 | dns_network | DNS lookup |
| 27 | dev_tools | npm, GitHub |
| 28 | tech_news | HackerNews |
| 29 | travel | trip planner |
| 30 | market_brief | market snapshot |
| 31 | compare | compare two |
| 32 | email_validation | email check |
| 33 | url_check | URL scan |
| 34 | mac_vendor | device vendor |
| 35 | anime | quotes, facts, Ghibli |
| 36 | pokemon | stats, types, moves |
| 37 | horoscope | daily astrological info |
| 38 | science_facts | math/science trivia |
| 39 | entertainment | Star Wars, Rick & Morty |
| 40 | mock_data | users, posts, products |
| 41 | avatar_generator | pixel art, robots |
| 42 | profanity_filter | censor bad words |
| 43 | coding_contests | LeetCode, Codeforces |

## Why

| Before | After |
|--------|-------|
| Web search | API call |
| 500-2000 tokens | 50-100 tokens |
| minutes | <300ms |

**10-40x token savings.**