agentleFS
nikhonitnikhonit/social-media-api-skills/skills/github-api/SKILL.md

github-api

Skill3 starsChanged 3 months agoMIT-0View on GitHub

GitHub data toolkit via ScraperSocial — repositories, commits, contributors, issues, releases, languages, user profiles, repo search and trending.

5 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

3 rules. 0 are common, 2 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 5 edited versions we read keep these.

  • 2

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    You need to open issues, push code or comment: Read-only.

    line 49
  2. Very specific:

    Every script also accepts --limit, --cursor, --fields, --format and --fresh.

    line 80
  3. Distinctive:

    Every response uses the same envelope:

    line 88

“Common” is measured: kept by at least 6 in 10 of the 5 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

GitHub API skill

Read public GitHub data as clean JSON. This GitHub API skill covers repositories and their commits, contributors, issues, releases and language breakdown, plus user and organisation profiles, repo search and the trending list. Every endpoint costs 1 credit, making this the cheapest platform in the repo and a good one to test your key against.

This skill wraps 11 live GitHub endpoints from the ScraperSocial API. Public data only, returned as clean JSON.

When to use this skill

  • You are evaluating a dependency or a project and want its activity, contributors or release history.
  • You need issue lists for triage, changelog generation or research.
  • You are tracking what is trending, or searching repos by keyword.
  • A user pastes a GitHub URL and asks what the project is or how active it is.

Do not use this skill when

  • You are authenticated and near no rate limit. GitHub's own REST and GraphQL APIs are free, richer and support writes. Use this when you want one uniform client across many platforms, or want to avoid managing another token.
  • You need private repositories. Public data only.
  • You need to open issues, push code or comment. Read-only.

Setup

export SCRAPERSOCIAL_KEY=sk_live_...   # https://scrapersocial.com/app/keys

Signing up at scrapersocial.com/signup includes 100 free credits, no card required.

Permissions and scope

These scripts do exactly three things and nothing else: read one environment variable (SCRAPERSOCIAL_KEY), send HTTPS requests to https://api.scrapersocial.com (the host is a constant in the code, not configurable), and print JSON. They run as node scripts/<name>.js with no other shell use, no file writes and no persistence. call_endpoint.js accepts only the 11 documented /v1/github/ paths in the table below and refuses anything else before a request is made.

Scripts

ScriptWhat it doesInputCredits
get_repo.jsGet GitHub repo.handle1 credit
get_repo.js --section=commitsList GitHub repo commits.handle1 credit per commit
get_repo.js --section=contributorsList GitHub repo contributors.handle1 credit per contributor
get_repo.js --section=issuesList GitHub repo issues.handle1 credit per issue
get_repo.js --section=languagesList GitHub repo languages.handle1 credit per language
get_repo.js --section=releasesList GitHub repo releases.handle1 credit per release
get_repo.js --section=searchList GitHub repo search.query1 credit per repo
get_repos.js --section=org-reposList GitHub org repos.handle1 credit per repo
get_repos.js --section=user-reposList GitHub user repos.handle1 credit per repo
get_profile.jsGet GitHub profile.handle1 credit
get_trending.jsList GitHub trending.query1 credit per repo
call_endpoint.jsCall any /v1/github/ endpoint directlypath + paramsvaries

Every script also accepts --limit, --cursor, --fields, --format and --fresh. --limit is clamped to 50: above that the API returns an async job instead of data.

Example

node skills/github-api/scripts/get_profile.js torvalds

Every response uses the same envelope:

{ "data": {}, "meta": { "count": 20, "next_cursor": "..." }, "request_id": "a18e4ef88ad4b00b" }

meta appears on paginated endpoints only. Keep request_id — support traces calls with it.

Endpoints

EndpointInputReturnsCreditsPaginated
/v1/github/org-reposhandlerepo1 credit per repoyes
/v1/github/profilehandleprofile1 creditno
/v1/github/repohandlerepo1 creditno
/v1/github/repo-commitshandlecommit1 credit per commityes
/v1/github/repo-contributorshandlecontributor1 credit per contributoryes
/v1/github/repo-issueshandleissue1 credit per issueyes
/v1/github/repo-languageshandlelanguage1 credit per languageyes
/v1/github/repo-releaseshandlerelease1 credit per releaseyes
/v1/github/repo-searchqueryrepo1 credit per repoyes
/v1/github/trendingqueryrepo1 credit per repoyes
/v1/github/user-reposhandlerepo1 credit per repoyes

Costs shown per item for paginated endpoints, per call otherwise. Failed calls are not charged.

FAQ

How do I get a repo's commits as JSON?

get_repo.js --section=commits with the owner/name handle. Commits, contributors, issues, languages and releases are all sections of the same script.

How do I list a user's or an organisation's repositories?

get_repos.js --section=user-repos or get_repos.js --section=org-repos, passing the handle.

Why use this instead of GitHub's own API?

Mostly consistency: same envelope, same auth and same client as the other 32 platforms here. If GitHub is the only source you need, their official API is free and a better fit.

Is this an official GitHub API?

No. ScraperSocial is independent and not affiliated with GitHub. It returns publicly available data only.

Links

Disclaimer

ScraperSocial is an independent product and is not affiliated with, endorsed by, or sponsored by any platform named in this repository. All product names, logos and brands are property of their respective owners. These skills return only publicly available data.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.