Agent skill

Literate R Formats

by r-lib in r-lib/lintr

Guidelines and architecture for handling literate R documents (.Rmd, .qmd, .Rnw, .Rhtml, .Rtex, .Rrst, .Rtxt) and source extraction in the r-lib/lintr package.

Custom licenceAuto-check passedDevelopment

Install Literate R Formats

skills CLI
$ npx skills add r-lib/lintr --skill literate-r-formats -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install r-lib/lintr literate-r-formats --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/r-lib/lintr.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/literate-r-formats .claude/skills/literate-r-formats && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
literate-r-formats
GitHub stars
1.3k
Token cost
~1k tokens
SKILL.md length
339 words
Files
1
Skills in repo
4
Repo updated
First seen
Licence
Custom licence

At a glance

Guidelines and architecture for handling literate R documents (.Rmd, .qmd, .Rnw, .Rhtml, .Rtex, .Rrst, .Rtxt) and source extraction in the r-lib/lintr package.

  • Works in 4 steps: Line & Column Preservation via… → Chunk Bounds & eval=FALSE Filtering → Engine Detection → …
  • Modifying R/extract.R
  • SKILL.md covers 1. Line & Column Preservation…, 2. Chunk Bounds & eval=FALSE…, 3. Engine Detection and 4. Multi-Format Testing…
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Literate R Formats is an agent skill from r-lib/lintr. Guidelines and architecture for handling literate R documents (.Rmd, .qmd, .Rnw, .Rhtml, .Rtex, .Rrst, .Rtxt) and source extraction in the r-lib/lintr package. Use when modifying R/extract.R, R/getsourceexpressions.R, or tests/testthat/test-knitrformats.R. Don't use for standard .R file linters that do not interact with chunk extraction.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Linting and formatting. The repository describes itself as: Static Code Analysis for R.

When your agent uses it

  • Modifying R/extract.R
  • R/getsourceexpressions.R
  • Tests/testthat/test-knitrformats.R
  • Standard .R file linters that do not interact with chunk extraction

Example prompts

  • “Use the literate-r-formats skill to guideline and architecture for handling literate R documents (.Rmd, .qmd, .Rnw, .Rhtml, .Rtex, .Rrst, .Rtxt) and…”
  • “/literate-r-formats”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Line & Column Preservation via NA_character_ & Prefix Masking
  2. Chunk Bounds & eval=FALSE Filtering
  3. Engine Detection
  4. Multi-Format Testing Conventions (tests/testthat/test-knitr_formats.R)

What it can do on your machine

Read from SKILL.md and the folder at commit 6dda4e3. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are r).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Literate R Formats loads about 1k tokens when it runs. Until then it costs about 96 tokens; SKILL.md has 339 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~96
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 339 words (~1,046 tokens).

“When modifying how lintr extracts R source code from literate programming and multi-language documents (RMarkdown .Rmd, Quarto .qmd, Sweave .Rnw, HTML .Rhtml, LaTeX .Rtex, reST .Rrst, or AsciiDoc .Rtxt), adhere to the following architectural conventions in R/extract.R:”

— opening of SKILL.md by r-lib, Custom licence
name
literate-r-formats

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/literate-r-formats of r-lib/lintr.

Open the folder on GitHubat commit 6dda4e3

Compare with similar skills

Literate R Formats next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Literate R Formats compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Literate R Formats this skillr-lib/lintr1.3k—~1kAutomated safety check: PassCustom licence
Minimizing Ty Ecosystem Changesastral-sh/ruff50k—~4.6kAutomated safety check: PassMIT
Install Anti-Slop Oxlint Rulesdmmulroy/anti-slop5.4k—~2.2kAutomated safety check: PassMIT
Babysit PR To Pass CIsgl-project/sglang37k2 repos~3kAutomated safety check: PassApache-2.0
Rust Best Practicesfarm-fe/farm5.6k3 repos~1.1kAutomated safety check: PassMIT
Summarise Ecosystem Resultsastral-sh/ruff50k—~2.2kAutomated safety check: PassMIT

Similar skills

  • Official

    A skill your agent uses when a user says "minimize this ty ecosystem change", "reproduce this ecosystem result", "investigate a primer difference", "investigate a mypyprimer difference"…

    50k GitHub stars~4.6k tokensUpdated today
    DevelopmentAuto-check passed
  • Installs, updates or migrates the vendored anti-slop Oxlint plugin in a repository, keeping local rule changes and the plugin's license and provenance files.

    5.4k GitHub stars~2.2k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Babysit PR To Pass CI

    sgl-project/sglang

    Start and persistently pursue a goal to babysit an SGLang pull request until selected GitHub Actions workflows pass on the latest PR head.

    37k GitHub starsUsed in 2 repos~3k tokens
    DevelopmentAuto-check passed
  • Guide for writing idiomatic Rust code based on Apollo GraphQL's best practices handbook.

    5.6k GitHub starsUsed in 3 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Official

    A skill your agent uses when a user says "summarise ecosystem results", "summarize this ty ecosystem report", "what changed in this ecosystem run?", or asks to summarise or summarize ty ecosystem…

    50k GitHub stars~2.2k tokensUpdated today
    DevelopmentAuto-check passed
  • Go Pedantry

    chromedp/chromedp

    This skill should be used when the user is writing Go code and needs guidance on Go-specific pedantry: error wrapping with fmt.Errorf and %w, interface design (accept interfaces return structs)…

    13k GitHub stars~3.7k tokensUpdated today
    DevelopmentAuto-check passed

More from r-lib/lintr

  • Guidelines and best practices for creating, extending, and refactoring linters in the r-lib/lintr package.

    1.3k GitHub stars~4.1k tokensUpdated today
    Auto-check passed
  • Testing Linters

    r-lib/lintr

    Guidelines and conventions for writing unit tests for linters in the r-lib/lintr package using testthat.

    1.3k GitHub stars~3.6k tokensUpdated today
    Auto-check passed
  • Xpath Style

    r-lib/lintr

    Guidelines and conventions for writing, composing, optimizing, and formatting XPath 1.0 expressions in the r-lib/lintr package.

    1.3k GitHub stars~4k tokensUpdated today
    Auto-check passed

Categories

Questions about Literate R Formats

What does Literate R Formats do?

Guidelines and architecture for handling literate R documents (.Rmd, .qmd, .Rnw, .Rhtml, .Rtex, .Rrst, .Rtxt) and source extraction in the r-lib/lintr package. Literate R Formats is an agent skill from r-lib/lintr.Rtxt) and source extraction in the r-lib/lintr package.

When should I use Literate R Formats?

Literate R Formats fits situations like: modifying R/extract.R; R/getsourceexpressions.R; tests/testthat/test-knitrformats.R; standard .R file linters that do not interact with chunk extraction.

How do I install Literate R Formats in Claude Code?

Run `npx skills add r-lib/lintr --skill literate-r-formats -a claude-code`. Or copy the skill folder (.agents/skills/literate-r-formats in r-lib/lintr) into .claude/skills/literate-r-formats in your project. Claude Code loads it when a task matches its description.

How do I install Literate R Formats in Codex?

Run `npx skills add r-lib/lintr --skill literate-r-formats -a codex`. Or copy the skill folder (.agents/skills/literate-r-formats in r-lib/lintr) into .agents/skills/literate-r-formats in your project. Codex loads it when a task matches its description.

Can I use Literate R Formats in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add r-lib/lintr --skill literate-r-formats -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/literate-r-formats, .gemini/skills/literate-r-formats, .github/skills/literate-r-formats and .opencode/skills/literate-r-formats in your project.

What does Literate R Formats need to run?

SKILL.md names no scripts, command-line tools or credentials: Literate R Formats is instructions for the agent only.

Does Literate R Formats access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Literate R Formats safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Literate R Formats use?

Literate R Formats has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Literate R Formats use?

About 1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Literate R Formats?

Skills that share tags, products or a category with Literate R Formats: Minimizing Ty Ecosystem Changes (astral-sh/ruff, 50k stars), Install Anti-Slop Oxlint Rules (dmmulroy/anti-slop, 5.4k stars), Babysit PR To Pass CI (sgl-project/sglang, 37k stars) and Rust Best Practices (farm-fe/farm, 5.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Literate R Formats?

r-lib (a GitHub organization) maintains it in r-lib/lintr, which has 1,297 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on October 11, 2026.

Source: r-lib/lintr on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.