r-documentation
R package documentation with roxygen2 and Rd files, including mathematical notation, selective Rd parsing, and structured sections. Use when writing/updating/refactoring roxygen2 documentation, adding math formulas to R help pages, programmatically reading Rd files, or troubleshooting Rd rendering
99
100%
Does it follow best practices?
Impact
96%
1.57xAverage score across 3 eval scenarios
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that hits all the key criteria. It provides specific concrete actions, uses natural R developer terminology as trigger terms, explicitly states both what the skill does and when to use it with a clear 'Use when...' clause, and is highly distinctive to the R ecosystem.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'roxygen2 and Rd files', 'mathematical notation', 'selective Rd parsing', 'structured sections', 'writing/updating/refactoring roxygen2 documentation', 'adding math formulas', 'programmatically reading Rd files', 'troubleshooting Rd rendering'. | 3 / 3 |
Completeness | Clearly answers both what ('R package documentation with roxygen2 and Rd files, including mathematical notation, selective Rd parsing, and structured sections') AND when ('Use when writing/updating/refactoring roxygen2 documentation, adding math formulas to R help pages, programmatically reading Rd files, or troubleshooting Rd rendering'). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms R developers would use: 'roxygen2', 'Rd files', 'R help pages', 'math formulas', 'Rd rendering', 'R package documentation'. These are the exact terms users would mention when needing this skill. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with R-specific terminology (roxygen2, Rd files, R help pages) that clearly separates it from general documentation skills or other programming language documentation tools. Unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-crafted skill document that efficiently covers R documentation with roxygen2 and Rd files. It provides concrete, executable examples throughout, maintains clear workflow guidance with validation steps, and appropriately delegates advanced topics to reference files. The content assumes Claude's competence while providing the specific, non-obvious details needed for this domain.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient, avoiding explanations of basic R or documentation concepts. Every section provides specific, non-obvious information like the gotcha about \describe vs \itemize item syntax and the two-argument form requirement for math macros. | 3 / 3 |
Actionability | Provides fully executable R code examples throughout - roxygen2 blocks, Rd parsing with vapply, section extraction, and verification commands. All examples are copy-paste ready with specific function calls and expected outputs. | 3 / 3 |
Workflow Clarity | The Verification Workflow section provides a clear numbered sequence with explicit validation steps (parse_Rd, checkRd, Rd2txt) and a checklist of what to verify. The workflow includes implicit feedback loops through the validation checks. | 3 / 3 |
Progressive Disclosure | Excellent structure with core content in the main file and clear one-level-deep references to math-formatting.md and rd-parsing.md. Each reference includes specific guidance on when to load it (e.g., 'Load when writing complex math'). | 3 / 3 |
Total | 12 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- jjjermiah/dotagents
- Commit
b74de5e
- Reviewed
Table of Contents
Is this your skill?
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.