zhangdw/astra-skills-scripts

🛠️ ASTRA Skills Scripts: Script-Backed Skills from the Agent Skill Tool-use Repository Atlas

Script-backed skills from the Agent Skill Tool-use Repository Atlas

<p align="center" style="text-align:center; white-space:nowrap;"><a href="https://huggingface.co/datasets/zhangdw/astra-skills-scripts"><img src="https://img.shields.io/badge/Hugging%20Face-Dataset-yellow?logo=huggingface" alt="Hugging Face Dataset" style="display:inline-block; vertical-align:middle; margin:0 3px;"></a>&nbsp;<img src="https://img.shields.io/badge/ASTRA-Agent%20Skill%20Tool--use%20Repository%20Atlas-6c5ce7" alt="ASTRA: Agent Skill Tool-use Repository Atlas" style="display:inline-block; vertical-align:middle; margin:0 3px;">&nbsp;<img src="https://img.shields.io/badge/Script%20Skills-28%2C954-00b894" alt="28,954 script-backed skills" style="display:inline-block; vertical-align:middle; margin:0 3px;">&nbsp;<img src="https://img.shields.io/badge/Subset-19.55%25%20of%20ASTRA%20Skills-blue" alt="19.55% of ASTRA Skills" style="display:inline-block; vertical-align:middle; margin:0 3px;">&nbsp;<img src="https://img.shields.io/badge/Archive-1.84%20GiB-2d3436" alt="1.84 GiB archive" style="display:inline-block; vertical-align:middle; margin:0 3px;"></p>

<p align="center"> <b>ASTRA Skills Scripts</b> contains only skill directories from <code>zhangdw/astra-skills</code> that include a <code>scripts/</code> subdirectory, making it easier to study agent skills that pair written instructions with runnable helper code. </p>

<p align="center"> <a href="#-quick-start"><b>Quick Start</b></a> · <a href="#-dataset-at-a-glance"><b>At a Glance</b></a> · <a href="#-subset-definition"><b>Subset Definition</b></a> · <a href="#-directory-format"><b>Directory Format</b></a> </p>

[!IMPORTANT] This dataset is a filtered subset of the public <a href="https://huggingface.co/datasets/zhangdw/astra-skills">ASTRA Skills Collection</a>. The dataset-level metadata and packaging are released under Apache-2.0, but individual skill files and scripts remain subject to their original repository licenses. Inspect upstream licenses before redistribution, execution, training, or benchmark release.

✨ Why a Scripts Subset?

Many agent skills are pure instruction documents. Others include executable helpers, shell scripts, Python utilities, templates, or workflow code under scripts/. The scripts-backed subset is useful when the research question is not only what agents are told to do, but how skills operationalize those instructions through local tools.

This subset helps answer questions like:

• —Which real-world skills rely on runnable helper scripts?
• —How do `SKILL.md` instructions describe when and how to call scripts?
• —What tool-use patterns appear around code generation, browser work, document editing, data processing, and automation?
• —How can retrieval systems surface skills that include executable affordances, not just prose instructions?

📦 Dataset at a Glance

<table> <tr> <td align="center"><b>28,954</b><br/>skills with <code>scripts/</code></td> <td align="center"><b>4</b><br/>split archive parts</td> <td align="center"><b>1.84 GiB</b><br/>compressed archive</td> <td align="center"><b>Strict Subset</b><br/>of <code>zhangdw/astra-skills</code></td> </tr> <tr> <td align="center"><b>19.55%</b><br/>of the full corpus</td> <td align="center"><b>2026-04-15</b><br/>extraction date</td> <td align="center"><b>GitHub</b><br/>source lineage</td> <td align="center"><b>Script-Backed</b><br/>agent workflows</td> </tr> </table>

Snapshot Summary

🧩 Subset Definition

🗂️ Dataset Files

🚀 Quick Start

Download the dataset with the current Hugging Face Hub CLI:

uvx --from huggingface_hub hf download zhangdw/astra-skills-scripts \
  --type dataset \
  --local-dir astra-skills-scripts

Merge the split archive and extract it:

cat astra-skills-scripts/astra-skills-scripts-part-*.tar.gz > astra-skills-scripts.tar.gz
tar xzf astra-skills-scripts.tar.gz

This produces a github/ directory containing script-backed skill directories.

Inspect a few script-backed skills:

find github -path '*/scripts' -type d | head
find github -name SKILL.md | head

🧱 Directory Format

Each saved skill directory comes from the parent ASTRA Skills corpus and includes a scripts/ subdirectory.

github/
└── {source}_{owner}_{skill_name}/
    ├── SKILL.md
    ├── _meta.json
    ├── scripts/
    └── [optional files, e.g. templates/, examples/, assets/]

_meta.json stores provenance metadata from the original crawl, such as source site, repository URL, owner, repository name, skill name, and relative path inside the upstream repository.

🔎 Example Discovery Workflows

<details open> <summary><b>List common script file extensions</b></summary>

from collections import Counter
from pathlib import Path

counts = Counter()

for scripts_dir in Path("github").rglob("scripts"):
    if scripts_dir.is_dir():
        for path in scripts_dir.rglob("*"):
            if path.is_file():
                counts[path.suffix.lower() or "[no extension]"] += 1

print(counts.most_common(20))

</details>

<details> <summary><b>Find skills whose instructions mention script execution</b></summary>

rg -n "scripts/|run .*script|execute|python|bash|node" github -g 'SKILL.md'

</details>

<details> <summary><b>Build a lightweight metadata table</b></summary>

import json
from pathlib import Path

rows = []

for meta_file in Path("github").rglob("_meta.json"):
    skill_dir = meta_file.parent
    meta = json.loads(meta_file.read_text())
    rows.append({
        "skill_dir": str(skill_dir),
        "script_files": sum(1 for p in (skill_dir / "scripts").rglob("*") if p.is_file()),
        "meta": meta,
    })

print(len(rows))
print(rows[:3])

</details>

✅ Intended Use

ASTRA Skills Scripts is designed for:

• —research on script-backed agent workflows and executable skill affordances;
• —skill retrieval and routing experiments that need a has_scripts signal;
• —analysis of how SKILL.md instructions coordinate with helper code;
• —studying tool invocation patterns, script conventions, and repository provenance;
• —constructing smaller benchmark or training subsets from the full ASTRA Skills corpus.

🛠️ Maintenance Notes

This dataset is a static extraction from the full ASTRA Skills snapshot. It preserves the parent corpus layout while filtering for directories that include scripts/. Because scripts can execute arbitrary upstream code, treat this dataset as research material: inspect code before running it, sandbox execution, and retain upstream provenance when deriving new artifacts.

👤 Author

• —Dawei Zhang (GitHub: zhangdw156)

📚 Citation

If you use ASTRA Skills Scripts in research, please cite this dataset, the full ASTRA Skills Collection, and any upstream repositories whose skill contents or scripts are central to your analysis.

@misc{astraSkillsScripts2026,
  author       = {Dawei Zhang},
  title        = {ASTRA Skills Scripts: Script-Backed Skills from the Agent Skill Tool-use Repository Atlas},
  year         = {2026},
  howpublished = {Hugging Face Dataset},
  publisher    = {Hugging Face},
  doi          = {10.57967/hf/8428},
  url          = {https://huggingface.co/datasets/zhangdw/astra-skills-scripts},
  note         = {Scripts-focused subset of ASTRA Skills; snapshot date: 2026-04-15; DOI record revision: 77d9d29}
}

For completeness, also cite the parent collection:

@misc{astraSkills2026,
  author       = {Dawei Zhang},
  title        = {ASTRA Skills: Agent Skill Tool-use Repository Atlas},
  year         = {2026},
  howpublished = {Hugging Face Dataset},
  publisher    = {Hugging Face},
  doi          = {10.57967/hf/8399},
  url          = {https://huggingface.co/datasets/zhangdw/astra-skills},
  note         = {Snapshot date: 2026-04-15; DOI record revision: 146eb8c}
}

📄 License

Dataset metadata and packaging are released under Apache-2.0. Individual skill contents and scripts remain subject to their original repository licenses.

<div align="center">

<b>ASTRA Skills Scripts makes script-backed agent skills easier to inspect, compare, and study at scale.</b>

</div>