Back to Feed
Agents

A Large Dataset of Agent Skills

Original: GitSkills: A Dataset of Agent Skills on GitHub

Listen to the summary

Uses a voice available on your device

Audio options
On this page 4 sections
Related concepts 2 concepts

Key Takeaways

  • The GitSkills dataset aggregates 3,797,117 SKILL.md files from 282,200 public GitHub repositories.
  • The data represents 1,877,981 distinct file contents after deduplication based on content hashes.
  • Over half (50.5%) of the collected files are verbatim copies of other skills found within the dataset.
  • The dataset includes enriched metadata such as YAML front matter, repository context, and commit history.

Summary & Methodology Analysis

To address the lack of systematic data regarding agent skills, the researchers developed a methodology to crawl GitHub for SKILL.md files. Given the constraints of the GitHub code-search API, they partitioned the search space by file size to ensure complete retrieval. They then performed deduplication by grouping files by content hash to select unique representatives. This process resulted in a dataset containing 3,797,117 files from 282,200 repositories, capturing 1,877,981 distinct contents. Enrichment was applied to each representative file by capturing full text, parsed YAML front matter, folder contents, repository metadata, and sampled commit history. To ensure data privacy, the team performed anonymization by replacing commit author accounts with keyed one-way codes and redacting personal names and email addresses. The resulting dataset provides a foundation for analyzing how developers write and maintain instructions for language-model agents, which are systems that use a transformer (a deep learning model architecture that processes data sequences using self-attention mechanisms) to perform tasks. The collection is limited to files found on default branches in public repositories, excludes files larger than 384 KB, and only tracks certain active repositories. These factors mean the current dataset size serves as a lower bound for the total number of agent skills available on the platform.

Interactive System Flowchart

Click diagram to expand and zoom

Cross-Examination & FAQs

A deeper dive clarifying mechanics, constraints, and baseline evaluations.

Q1. What is the GitSkills dataset?

It is a collection of 3,797,117 agent skill instructions gathered from public GitHub repositories.

Q2. Why was this dataset created?

It was created to fill the lack of systematic data regarding how developers write and maintain instructions for language-model agents.

Q3. What is a SKILL.md file?

It is a file format used to store natural language instructions for language-model agents.

Q4. How did the researchers handle API rate limits during data collection?

They partitioned the search space by file size to bypass GitHub code-search API limits.

Q5. What percentage of the files are unique?

The dataset contains 1,877,981 distinct file contents, meaning 50.5% of the collected files are verbatim copies of others.

Q6. How was the data processed to protect user privacy?

The authors used anonymization to replace commit author accounts with keyed one-way codes and redacted personal names and email addresses.

Q7. What metadata is included in the dataset?

Each representative file includes full text, parsed YAML front matter, folder contents, repository metadata, and sampled commit history.

Q8. What are the limitations of the GitSkills dataset?

It is limited to public repositories, indexes only default branches, excludes files larger than 384 KB, and only covers certain active repositories.

Q9. Does this dataset capture all agent skills on GitHub?

No, the researchers state that the dataset represents a lower bound because of the specific filtering and inclusion criteria used.