Skills

A skill is a package of structured files that teaches an AI coding agent how to work with a specific tool or framework. Install it in your agent and it will be able to run commands, edit configuration, write content, and troubleshoot problems without step-by-step guidance from you.

Any agent — install with npx:

npx skills add test-org/gdtest-skill-curated

Codex / OpenCode

Tell the agent:
Fetch the skill file from https://github.com/test-org/gdtest-skill-curated and follow the instructions.

Manual — download the skill file:

curl -O <site-url>/skill.md

Or browse the SKILL.md file.

SKILL.md

---
name: gdtest-skill-curated
description: >
  Fetch, parse, and cache web content with gdtest-skill-curated.
  Use when writing Python code that fetches URLs, parses HTML,
  or needs in-memory caching.
license: MIT
compatibility: Requires Python >=3.10.
metadata:
  author: gdg-test-suite
  version: "1.0"
---

# gdtest-skill-curated

A lightweight toolkit for fetching, parsing, and caching web content.

## Installation

```bash
pip install gdtest-skill-curated
```

## When to use what

| Need | Use |
|------|-----|
| Fetch a URL | `fetch(url)` |
| Parse HTML content | `parse(html, selector)` |
| Cache results in memory | `CacheStore()` |
| Set cache TTL | `CacheStore(ttl=seconds)` |
| Limit cache size | `CacheStore(max_size=n)` |

## Gotchas

1. **Always set a timeout** when calling `fetch()` — the default is
   30 seconds, which may be too long for interactive use.
2. **`parse()` returns a list**, not a string. Even for a single
   match you get a one-element list.
3. **`CacheStore` is not thread-safe.** Use a lock if sharing across
   threads.
4. The module name is `gdtest_skill_curated`, not
   `gdtest-skill-curated`.

## Capabilities and boundaries

**What agents can configure:**

- Fetch URLs with custom timeouts
- Parse HTML with CSS selectors
- Create and query in-memory caches
- Set TTL and max size on caches

**Requires human setup:**

- Network access for `fetch()`
- Installing the package (`pip install`)

## Resources

- [llms.txt](llms.txt) — Indexed API reference for LLMs
- [llms-full.txt](llms-full.txt) — Full documentation for LLMs