home / skills / pproenca / dot-skills / valid-skill

valid-skill skill

safe

This skill helps validate and test agent skills by providing a reference format and guidelines for usage and validation workflows.

This is most likely a fork of the valid-skill skill from pluk-inc

npx playbooks add skill pproenca/dot-skills --skill valid-skill

Review the files below or copy the command above to add this skill to your agents.

Files (3)

SKILL.md

541 B

---
name: valid-skill
description: A valid test skill with proper formatting. This skill should pass all validations and serves as a reference for the expected format.
---

# Valid Skill

A simple valid skill for testing purposes.

## When to Apply

Reference these guidelines when testing the skills-ref validator.

## Quick Reference

### 1. Example Category (CRITICAL)

- `example-rule-one` - First example rule for testing
- `example-rule-two` - Second example rule for testing

## How to Use

This skill is used for testing validation.

Overview

This skill provides a concise, well-formatted test example for validating agent skill metadata and structure. It demonstrates expected layout, categories, and basic rules to help authors and tools verify compliance. Use it as a clear reference when building or testing other skills.

How this skill works

The skill defines a minimal, valid skill manifest and a short usage guide to exercise validators and linters. It outlines an example category and two example rules that represent typical validation checks. Validators can parse the manifest, verify required fields, and ensure formatting follows the expected patterns.

When to use it

Testing and validating skill manifests and metadata parsers
As a reference template when authoring new skills
Running automated checks in CI pipelines to ensure formatting standards
Teaching contributors how skill definitions should be structured

Best practices

Keep the skill manifest minimal and focused on required fields
Use clear, descriptive names for categories and rules
Include a short how-to or usage note to clarify intent
Run schema validation and linting before publishing
Treat this skill as a canonical example when updating validation rules

Example use cases

CI job that validates skill metadata against the schema
Developer guide demonstrating a correct skill layout
Tooling tests that assert parsers accept valid inputs
Onboarding document for new contributors to show a compliant example

FAQ

What is the primary purpose of this skill?

To serve as a minimal, correct example for testing validators, linters, and tooling that process skill definitions.

Can I copy this skill as a starting point?

Yes. Use it as a template to ensure your manifest includes required fields and follows expected formatting before adding custom content.