vague

1 stars
14
A

Use when writing Vague (.vague) files - a declarative language for generating realistic test data with superposition, constraints, and cross-references

Also in: data analysis

Third-Party Agent Skill: Review the code before installing. Agent skills execute in your AI assistant's environment and can access your files. Learn more about security

Installation for Agentic Skill

View all platforms →
skilz install mcclowes/vague/vague
skilz install mcclowes/vague/vague --agent opencode
skilz install mcclowes/vague/vague --agent codex
skilz install mcclowes/vague/vague --agent gemini

First time? Install Skilz: pip install skilz

Works with 22+ AI coding assistants

Cursor, Aider, Copilot, Windsurf, Qwen, Kimi, and more...

View All Agents
Download Agent Skill ZIP

Extract and copy to ~/.claude/skills/ then restart Claude Desktop

1. Clone the repository:
git clone https://github.com/mcclowes/vague
2. Copy the agent skill directory:
cp -r vague/.claude/skills/vague ~/.claude/skills/

Need detailed installation help? Check our platform-specific guides:

Related Agentic Skills

Agentic Skill Details

Repository
vague
Stars
1
Type
Technical
Meta-Domain
development
Primary Domain
testing
Market Score
14

Agent Skill Grade

A
Score: 90/100 Click to see breakdown

Score Breakdown

Spec Compliance
12/15
PDA Architecture
28/30
Ease of Use
22/25
Writing Style
9/10
Utility
19/20

Areas to Improve

  • Missing TOC in long reference files
  • No end-to-end workflow example
  • Redundant plugin examples

Recommendations

  • Add trigger phrases to description for discoverability
  • Add table of contents for files over 100 lines

Graded: 2026-01-24

Developer Feedback

I've been digging through skills lately and yours came up with a solid 90—definitely above the noise floor. The concept feels intentionally vague in a way that suggests you're handling some real complexity under the hood, which is exactly when clarity becomes the hard part.

Links:

TL;DR

You're at 90/100, solid A territory. This is based on Anthropic's skill best practices rubric. Strongest area: Utility (19/20)—you've actually solved a real problem with comprehensive test data generation. Weakest area: Spec Compliance (12/15)—your description could use a few more trigger phrases to help people discover this when they need it.

What's Working Well

  • Progressive Disclosure is chef's kiss. Your SKILL.md stays lean and focused while references like syntax.md and plugins.md handle the deep dives. That's exactly how layering should work (28/30 on PDA).
  • The utility is genuinely strong. You're not just documenting a tool—you're providing real validation patterns (constraints, dataset validation, OpenAPI validation). That's the difference between a reference and something people actually use.
  • Token economy. Nearly every sentence pulls its weight. No fluff about "why Vague matters" or "test data is important"—just straight to solving the problem.
  • Consistent terminology throughout. Schema, dataset, superposition, constraints—you stick with it, which keeps things clear even when diving into complex features.

The Big One: Missing End-to-End Workflow

Here's what's holding you back from a 91+: Your Quick Start shows syntax, but there's no complete workflow showing the actual problem-solving loop. Right now someone can learn how to write Vague, but not when or why in context.

Fix this by adding to SKILL.md:

## Complet...

Report Security Issue

Found a security vulnerability in this agent skill?