vague
Use when writing Vague (.vague) files - a declarative language for generating realistic test data with superposition, constraints, and cross-references
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/vagueskilz install mcclowes/vague/vague --agent opencodeskilz install mcclowes/vague/vague --agent codexskilz install mcclowes/vague/vague --agent geminiFirst time? Install Skilz: pip install skilz
Works with 22+ AI coding assistants
Cursor, Aider, Copilot, Windsurf, Qwen, Kimi, and more...
Extract and copy to ~/.claude/skills/ then restart Claude Desktop
git clone https://github.com/mcclowes/vaguecp -r vague/.claude/skills/vague ~/.claude/skills/Need detailed installation help? Check our platform-specific guides:
Related Agentic Skills
pytest-config
by athola
Standardized pytest configuration patterns for plugin development. Reducesduplication across parseltongue, pensive, sanctum, and other plugins.Trig...
shell-testing-framework
by manutej
Shell script testing expertise using bash test framework patterns from unix-goto, covering test structure (arrange-act-assert), 4 test categories, ...
markdownlint-custom-rules
by TheBushidoCollective
Create custom linting rules for markdownlint including rule structure, parser integration, error reporting, and automatic fixing.
feature-dev
by secondsky
Automate 7-phase feature development with specialized agents (code-explorer, code-architect, code-reviewer). Use for multi-file features, architect...
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
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...
Browse Category
More development Agentic SkillsReport Security Issue
Found a security vulnerability in this agent skill?
Report Security Issue
Thank you for helping keep SkillzWave secure. We'll review your report and take appropriate action.
Note: For critical security issues that require immediate attention, please also email security@skillzwave.ai directly.