using-tidyjs

Enforce correct tidy() pipeline structure and function taxonomy for @tidyjs/tidy code.

1|Updated May 13, 2026
One-click install
npx skills add https://github.com/impact-initiatives/ana_app --skill using-tidyjs-impact-initiatives
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-tidyjs
Source: https://github.com/impact-initiatives/ana_app/tree/main/.claude/skills/tidy-js
Command: npx skills add https://github.com/impact-initiatives/ana_app --skill using-tidyjs-impact-initiatives

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It prevents subtle, hard-to-debug errors in tidyjs pipelines by ensuring you follow tidyjs’ distinctive pipeline pattern, function taxonomy, and accessor conventions before you write code.

Core Features & Use Cases

  • Correct pipeline pattern: Ensures you use tidy(data, ...verbs) so verbs are composed properly rather than called incorrectly.
  • Right function in the right place: Guides you to use mutate vs mutateWithSummary, summary functions in summarize/total specs, and vector functions only inside mutateWithSummary to avoid silent logic bugs.
  • Idiomatic accessors and selectors: Pushes you toward accessor functions for field references and proper selectors usage (e.g., in select() and pivotLonger({ cols: ... })).

Quick Start

Ask the AI to write your tidyjs pipeline while first checking the tidy mental model and the specific api docs for every function you plan to use.

Frequently Asked Questions about using-tidyjs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure a tidyjs pipeline correctly using the tidy function?

To structure a tidyjs pipeline correctly, use the tidy(data, ...verbs) pattern so verbs are composed properly rather than called incorrectly as standalone methods on arrays.

Why does my tidyjs mutate function produce incorrect data transformations?

Your tidyjs mutate function produces incorrect data because you are likely using summary or vector functions inside it; use mutateWithSummary for vector operations or summarize for summary functions to avoid silent logic bugs.

When should I use mutateWithSummary instead of mutate in tidyjs?

Use mutateWithSummary instead of mutate in tidyjs when you need to apply vector operations that require access to aggregated or summary data across the entire dataset during the transformation step.

How do I reference object fields correctly in tidyjs selectors and accessors?

To reference object fields correctly in tidyjs, use idiomatic accessor functions for field references and proper selectors usage within functions like select() and pivotLonger({ cols: ... }).

What are the common gotchas when writing tidyjs data wrangling code?

Common tidyjs data wrangling gotchas include using summary functions inside mutate, bypassing the tidy() pipeline structure, and using incorrect accessor conventions for field references, which cause silent logic bugs.

Can I use tidyjs for pivoting and joining arrays of objects in JavaScript?

Yes, you can use tidyjs for pivoting and joining arrays of objects in JavaScript by following the correct pipeline structure and applying proper selectors within pivot operations and join verbs to transform data accurately.