Claude Code Plugins

Community-maintained marketplace

Feedback

frago-view-content-generate-tips-json

@tsaijamey/frago
14
0

JSON 文件内容生成指南。当需要创建可通过 `frago view` 预览的 JSON 文件时使用此 skill。涵盖格式化显示、最佳实践。

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name frago-view-content-generate-tips-json
description JSON file content generation guide. Use this skill when you need to create JSON files that can be previewed via `frago view`. Covers formatted display and best practices.

JSON File Content Generation Guide

Preview JSON files via frago view with automatic formatting and syntax highlighting.

Preview Commands

frago view data.json                      # Default theme
frago view config.json --theme monokai    # Specify theme

Rendering Features

Automatic Formatting

  • JSON content automatically beautified (Pretty Print)
  • Indentation aligned
  • Key-value pairs clearly displayed

Syntax Highlighting

Element Color Example (github-dark)
Key names Purple #d2a8ff
String values Blue #a5d6ff
Numbers Cyan #79c0ff
Booleans Red #ff7b72
null Red #ff7b72
Brackets/commas White #c9d1d9

JSON Format Specification

Correct Format

{
    "name": "Project Name",
    "version": "1.0.0",
    "enabled": true,
    "count": 42,
    "tags": ["tag1", "tag2"],
    "config": {
        "nested": "value"
    },
    "nullable": null
}

Common Errors

Error Example Fix
Trailing comma {"a": 1,} {"a": 1}
Single quotes {'a': 1} {"a": 1}
Unquoted keys {a: 1} {"a": 1}
Comments // comment Comments not supported
undefined undefined Use null

Best Practices

1. Indentation

  • Use 2 or 4 spaces for indentation
  • Maintain consistency

2. Key Naming

  • Use snake_case or camelCase
  • Maintain consistency throughout the file
{
    "user_name": "snake_case style",
    "userName": "camelCase style"
}

3. Data Organization

  • Group related fields
  • Place important fields first
{
    "id": "001",
    "name": "Important fields first",
    "metadata": {
        "created_at": "2024-01-01",
        "updated_at": "2024-01-02"
    }
}

4. File Size

  • Single file < 1MB optimal
  • Consider pagination or splitting files for large data

Use Cases

  • API response data preview
  • Configuration file viewing
  • Data structure review
  • Debug data inspection

Display Themes

Same as code files, supports the following themes:

Theme Command
github-dark (default) frago view data.json
monokai frago view data.json --theme monokai
atom-one-dark frago view data.json --theme atom-one-dark

Notes

Issue Cause Solution
Parse failure JSON format error Use JSON validator
Truncated display Value too long Use nested structure
Slow rendering File too large Split or simplify

JSON Validation

Ensure JSON is valid before preview:

# Python validation
python -m json.tool data.json

# jq validation
jq . data.json

Related Tools

  • jq: Command-line JSON processor
  • jsonlint: JSON validator
  • VSCode: JSON editing and formatting