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
Install with Tessl CLI
npx tessl i github:jjjermiah/dotagents --skill r-documentation100
Does it follow best practices?
Validation for skill structure
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 a well-crafted skill description that excels across all dimensions. It provides specific capabilities (roxygen2, Rd files, math notation, parsing), uses natural R developer terminology as trigger terms, includes an explicit 'Use when' clause with multiple trigger scenarios, and is highly distinctive to the R ecosystem with no risk of conflicting with general documentation skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'R package documentation with roxygen2 and Rd files, including mathematical notation, selective Rd parsing, and structured sections' - covers documentation format, math notation, parsing, and sections. | 3 / 3 |
Completeness | Clearly answers both what (R package documentation with roxygen2/Rd, math notation, parsing, structured sections) AND when with explicit 'Use when' clause covering writing/updating/refactoring documentation, adding math, reading Rd files, and troubleshooting. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms R developers would use: 'roxygen2', 'Rd files', 'R help pages', 'math formulas', 'Rd rendering' - 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. | 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 that efficiently covers R documentation with roxygen2 and Rd files. It provides concrete, executable examples for all key operations, includes a clear verification workflow with validation steps, and appropriately delegates advanced topics to reference files. The gotchas and key rules sections add high-value, non-obvious information.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient, providing only R-specific documentation knowledge that Claude wouldn't inherently know (roxygen2 syntax, Rd parsing patterns, math notation gotchas). No unnecessary explanations of basic concepts. | 3 / 3 |
Actionability | Provides fully executable R code examples throughout - roxygen2 blocks, Rd parsing with tools::parse_Rd(), tag extraction, and verification commands. All examples are copy-paste ready with specific function calls. | 3 / 3 |
Workflow Clarity | The Verification Workflow section provides a clear numbered sequence with explicit validation steps (roxygenise → parse_Rd → checkRd → Rd2txt) and a checklist of what to verify. The workflow includes feedback for error detection. | 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. | 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.
- 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.