Skills

Agent Skills

• https://huggingface.co/learn/context-course/unit1/introduction
• A skill is a self-contained package of knowledge that makes an agent good at one specific task
• Typically SKILL.md markdown file containing metadata and instructions
• They are structured, reusable, and discoverable
• They live beyond a single conversation and can be loaded only when relevant
• Skills Registry
  • https://awesome-copilot.github.com/skills/
  • https://www.skills.sh/

Agent Skills Specification

• https://agentskills.io/
• originally created by Anthropic
• supported by 30+ code agents
• Directory Structure
  • Directory name should be lowercase with hyphens allowed

skill-name/
├── SKILL.md              # Required: metadata + instructions
├── scripts/              # Optional: executable code
│   ├── validate.py
│   ├── deploy.sh
│   └── README.md
├── references/           # Optional: documentation links
│   ├── api-reference.md
│   └── examples.md
└── assets/               # Optional: templates, data
    ├── template.yaml
    └── config-example.json

• SKILL.md
  • Frontmatter in YAML
    • Aim for
    • name: must match directory name
    • description: Start with verb
    • Optional
      • license
      • compatibility
      • metadata: key-value pairs
  • Body Content in Markdown
    • Aim for 400–800 lines
    • Link references, scripts, assets etc.
• Example

---
name: "model-card-generator"
description: "Generate model cards for Hugging Face Hub. Use when documenting models, adding metadata, or creating README files."
license: "MIT"
compatibility: "Python 3.8+, requires jinja2"
metadata:
  author: "context-course"
  version: "1.0.0"
  created: "2026-04-13"
---
 
# Model Card Generator Skill
 
## Overview
This skill helps create professional model cards and README files for models published to Hugging Face Hub. Model cards document:
- Model architecture and training data
- Intended use and limitations
- Performance metrics
- Ethical considerations
- License information
 
## Prerequisites Checklist
- [ ] Python 3.8+ installed
- [ ] jinja2 package installed
- [ ] Model information available (name, description, metrics)
 
## Step-by-Step Guide
 
### 1. Gather Model Information
Collect the following about your model:
- Model name and description
- Training data description
- Performance metrics (accuracy, F1, BLEU, etc.)
- Intended use cases
- Limitations
- License (MIT, Apache-2.0, CC-BY-4.0, etc.)
 
### 2. Generate Card
```python
from generate_card import create_model_card
 
metrics = {
    "accuracy": 0.92,
    "f1_score": 0.89,
    "precision": 0.91
}
 
card = create_model_card(
    model_name="My Classifier",
    description="A transformer-based text classifier",
    metrics=metrics
)
 
with open("README.md", "w") as f:
    f.write(card)
```
 
See [the generation script](scripts/generate_card.py) for more options.
 
### 3. Customize
Open README.md and add:
- Detailed description
- Training procedure
- Example usage
- Citation information
 
## Helper Scripts
- [Model card generator](scripts/generate_card.py)
- [Validation tool](scripts/validate_card.py)
 
## References
- [Model Cards Paper](https://arxiv.org/abs/1810.03993)
- [HF Model Card Template](../references/hf-template)
- [Best Practices](../references/best-practices)
 
## Troubleshooting
 
### Issue: Frontmatter not rendering
**Solution**: Ensure dashes are on their own lines in the YAML section:
```yaml
---
license: mit
---
```
 
### Issue: Characters not displaying
**Solution**: Save file as UTF-8 encoding:
```bash
file README.md
```

Invoking Skills

• Skills can be invoked by:
  • Implicit model invocation based on context
  • Explicit invocation using slash command

Skills size guidelines

• SKILL.md: 400-800 lines
• scripts/: each script < 500 lines
• Total skill: < 2MB

Location of Skills

• Claude
  • https://code.claude.com/docs/en/agent-sdk/skills
  • System: ~/.claude/skills
  • Project: .claude/skills
• GitHub Copilot
  • https://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/add-skills
  • System: ~/.copilot/skills
  • Project: .github/skills