markdown-files

Tool Skills

Reusable agent skills for structured file workflows:

• JSON operations with jq
• YAML operations with yq (v4 syntax)
• Markdown structure/prose cleanup with mdq query workflows

This repository is meant for both humans and coding agents. Human onboarding lives here; agent execution policy and CI commands live in AGENTS.md.

Included Skills

• plugins/json-files/skills/json-files/SKILL.md
• plugins/yaml-files/skills/yaml-files/SKILL.md
• plugins/markdown-files/skills/markdown-files/SKILL.md

Installation

1) Clone the repository

git clone [email protected]:pidster/tool-skills.git
cd tool-skills

2) Install required CLI tools

Core tools:

• jq for JSON skill workflows
• yq (Mike Farah v4) for YAML skill workflows
• mdq for Markdown querying by heading/list/code-block patterns

Preferred install method: Homebrew (brew) when available.

Install examples:

# macOS
brew install jq yq mdq

# Debian/Ubuntu
sudo apt-get update && sudo apt-get install -y jq
sudo snap install yq
cargo install mdq

# Windows (PowerShell)
winget install jqlang.jq
winget install MikeFarah.yq
cargo install mdq

3) Verify tools are available

jq --version
yq --version
mdq --version

Marketplace

Registered skills are listed in marketplace.json.

Current entries:

• json-files
• yaml-files
• markdown-files

Contributing

1. Add or update a skill in plugins/<skill-name>/skills/<skill-name>/SKILL.md.
2. Keep frontmatter metadata accurate (especially name, description, metadata.version).
3. Register new skills in marketplace.json.
4. Follow agent-facing validation and release checks in AGENTS.md.

CI

GitHub Actions workflow: .github/workflows/validate-skills.yml

It validates marketplace JSON, skill version alignment, and routing eval suites on pushes and pull requests.