yc-reader

1# Y Combinator Reader (Read-Only)
2 
3If your host has not already executed the shell probes below (for example, in Codex), run the commands inside the `!` wrappers with its shell tool before choosing a setup path. Use the actual output; if shell access is unavailable, report that limitation.
4 
5Fetches Y Combinator company data from the [yc-oss/api](https://github.com/yc-oss/api), an unofficial open-source API that indexes all publicly launched YC companies. The data is sourced from YC's Algolia search index and updated daily via GitHub Actions.
6 
7**This is a read-only data source.** It provides company profiles, batch listings, industry/tag breakdowns, hiring status, and diversity data. No write operations exist — the API serves static JSON files.
8 
9**No authentication required.** The API is public and free. Just use `curl` to fetch JSON endpoints.
10 
11---
12 
13## Step 1: Verify Prerequisites
14 
15This skill only needs `curl` (to fetch data) and `jq` (to parse/filter JSON). Both are pre-installed on most systems.
16 
17```
18!`(command -v curl > /dev/null && echo "CURL_OK" || echo "CURL_MISSING") && (command -v jq > /dev/null && echo "JQ_OK" || echo "JQ_MISSING")`
19```
20 
21If `JQ_MISSING`, install it:
22 
23```bash
24# macOS
25brew install jq
26 
27# Linux (Debian/Ubuntu)
28sudo apt-get install jq
29```
30 
31If `jq` is unavailable, you can still fetch raw JSON with `curl` and parse it inline with Python or other tools — but `jq` makes filtering much easier.
32 
33---
34 
35## Step 2: Identify What the User Needs
36…