Shuffle JSON Data Skill (awesome-copilot) for Claude Code: What It Does and How to Install It

Makes your agent randomize the order of repeated JSON objects, but only after confirming the file can be shuffled safely.

Installs: 8.7K; on skills.sh
Stars: 40.7K; on GitHub
Updated: Oct 2026; last repo commit

The agent checks three things before it shuffles: every object has the same property names, there are no nested objects, and the JSON is valid. If a check fails, it stops and reports the problem instead of changing the data. If no file is attached, it asks for one.

Three optional variables change the default: ignoreProperties, requiredProperties and nesting. It bundles no scripts. The example shows an invocation with a slash command and a #file reference, which is GitHub Copilot Chat style, but the rules apply to any JSON you give your agent.

Good for

Developers randomizing test data, quiz questions or fact lists
Data engineers who need to keep JSON valid and consistent

Install shuffle-json-data

Claude Code

Copy this prompt.

Install the shuffle-json-data skill in Claude Code. Run this command:

npx skills add https://github.com/github/awesome-copilot --skill shuffle-json-data

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

The awesome-copilot README is written for GitHub Copilot and does not name Claude Code, so the Claude Code and Codex routes are the standard skill-folder routes. It is one SKILL.md file and is not part of any awesome-copilot plugin listed in the repo.

Built from the package data we hold. Not yet tested by us. Source.

What's in the skill

When it loads

Shuffle repetitive JSON objects safely by validating schema consistency before randomising entries.

Sections in SKILL.md

Overview
Role
Objectives
Data Validation Checklist
Acceptable JSON
Unacceptable JSON (Default State)
Workflow
Requirements for Shuffling Data
Examples
Missing File
Custom Configuration
Default State
Variables

Key facts

Author: (awesome-copilot) - no author is named in the skill or repo files; the repo LICENSE names GitHub, Inc. as copyright holder
License: MIT (LICENSE file of the awesome-copilot repo)
Installs on skills.sh: 8,666 (Nov 2, 2026)
GitHub stars: 40,666 for the whole github/awesome-copilot repo (Nov 2, 2026)
Last repo commit: Oct 30, 2026
What it includes: 1 file: SKILL.md. No scripts
Audits on skills.sh: Gen Agent Trust Hub: pass, Socket: pass, Snyk: pass (Nov 2, 2026)

What it includes

Confirms a JSON file or structure is attached, and asks if not
1. Gather input
Merges defaults with any variables you supply
2. Review configuration
Applies the checklist and stops on any failure
The checklist covers matching property names, no nested objects and valid JSON.
3. Validate structure
Randomizes the collection or collections the settings describe
4. Shuffle data
Outputs the shuffled data with the original encoding and formatting
5. Return results
Properties the shuffle should ignore
Default is none.
ignoreProperties
Properties every object must have
Default is the first set of properties from the first object.
requiredProperties
Allows nested objects when your variables explain how to handle them
Default is false.
nesting

From the official docs

Questions

What does shuffle-json-data do?

It makes your agent shuffle the entries of a JSON file while keeping the JSON valid. It validates the file first and refuses to shuffle if the objects are inconsistent.

How do I install it?

Use the install box at the top of this page. It is one SKILL.md file, so there is nothing else to set up.

What input does it accept?

A JSON file or compatible JSON structure, usually an array of objects with the same property names. By default nested objects are rejected.

What are the variables?

ignoreProperties, requiredProperties and nesting. SKILL.md's example sets ignoreProperties to "year" and "category" and requiredProperties to "fact" for a funFacts.json file.

Does it use a script to shuffle?

The folder bundles no scripts. SKILL.md describes the workflow in plain steps for the agent to follow.

Is it safe?

It bundles no scripts. It stops and reports problems instead of changing inconsistent data. Our advice: keep a copy of your original file, and compare the output against it.

Information

updated Nov 2, 2026

Repository: github/awesome-copilot
Folder: skills/shuffle-json-data

github/awesome-copilot skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 2

awesome-copilot README · github.com
shuffle-json-data SKILL.md · github.com