← 返回 Skills 市场

flashformat

Name: flashformat
Author: phantom5125

作者 GreatHato · GitHub ↗ · v1.0.0

cross-platform ⚠ suspicious

343

总下载

当前安装

版本数

在 OpenClaw 中安装

/install flashformat

功能描述

Provide five repository-local format conversion scripts (yaml-to-json, json-to-yaml, markdown-to-text, json-minify, yaml-auto-fix) for offline CLI and pipeli...

使用说明 (SKILL.md)

FlashFormat Local Converters

Overview

Run local format conversion directly from Python scripts under skills/flashformat-local-converters/scripts/. Avoid calling /api/v2/*; execute conversion in local shell, CI, or offline pipelines.

Quick Start

Install runtime dependency: python -m pip install PyYAML
Run any converter script with one input channel: --input or --input-file or stdin
Choose output mode: plain text (default) or --json
Optionally write result to file: --output-file \x3Cpath>

Script Map

scripts/yaml_to_json.py: Convert YAML to JSON, support --indent and --compact
scripts/json_to_yaml.py: Convert JSON to YAML, support --sort-keys and --compact
scripts/markdown_to_text.py: Strip Markdown syntax into readable text
scripts/json_minify.py: Minify JSON to one-line payload
scripts/yaml_auto_fix.py: Apply conservative YAML whitespace/indent fixes with validation

Unified CLI Contract

Input priority: --input > --input-file > stdin
Output target: stdout by default, or --output-file
JSON mode payloads: {"ok": true, "tool": "...", "output": "..."} {"ok": false, "tool": "...", "error": "..."}
Plain mode failures write error text to stderr and return non-zero exit code

Usage Examples

YAML to JSON: python skills/flashformat-local-converters/scripts/yaml_to_json.py --input-file in.yaml --output-file out.json
JSON to YAML (sorted keys): python skills/flashformat-local-converters/scripts/json_to_yaml.py --input '{"b":2,"a":1}' --sort-keys
Markdown to text (stdin pipeline): cat draft.md | python skills/flashformat-local-converters/scripts/markdown_to_text.py
JSON minify with structured output: python skills/flashformat-local-converters/scripts/json_minify.py --input-file data.json --json
YAML auto-fix: python skills/flashformat-local-converters/scripts/yaml_auto_fix.py --input-file broken.yaml --indent-step 2 --fix-tabs --fix-odd-indent

References

Read references/io-contracts.md when exact options, error messages, and backend logic mapping are needed.

安全使用建议

This skill is internally consistent and appears to do what it claims: local text/YAML/JSON/Markdown conversions. Before installing or running: (1) review the scripts if you have concerns about reading or writing particular files — they will read any file path you pass via --input-file and write to --output-file; (2) install PyYAML from a trusted source (pip) in a controlled environment or virtualenv; (3) run the tools on non-sensitive sample data first to confirm behavior; (4) if you will add these to CI, ensure file paths and permissions are constrained so CI jobs don't expose secrets via input files. There is no evidence of network exfiltration or credential usage in the provided code or SKILL.md.

功能分析

Type: OpenClaw Skill Name: flashformat Version: 1.0.0 The skill provides a suite of Python scripts for local format conversion (JSON, YAML, Markdown) and minification. While the code is well-structured and uses secure practices such as 'yaml.safe_load', the shared utility script '_cli_common.py' implements arbitrary file read and write capabilities via the '--input-file' and '--output-file' arguments. Per the analysis criteria, the inclusion of broad file system access, even when plausibly required for the tool's stated purpose, is considered a high-risk behavior that warrants a suspicious classification.

能力评估

✓ Purpose & Capability

Name/description match the included Python scripts (yaml_to_json, json_to_yaml, markdown_to_text, json_minify, yaml_auto_fix). No unrelated env vars, binaries, or configuration paths are requested.

✓ Instruction Scope

SKILL.md instructs running the included scripts locally and explicitly avoids calling external APIs. The scripts only read input from --input/--input-file/stdin and write to stdout or a specified output file; they do not open network connections or access other system configuration.

✓ Install Mechanism

There is no install spec; this is an instruction-and-code skill. The only runtime dependency is PyYAML (installed via pip), which is reasonable for YAML handling. No downloads or archive extraction are performed.

✓ Credentials

The skill requests no environment variables or credentials. The code does file IO (read/write) consistent with a CLI conversion tool; no secrets or unrelated service tokens are required.

✓ Persistence & Privilege

always is false and the skill does not modify other skills or system-wide settings. It does not persist credentials or attempt to enable itself automatically.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install flashformat
安装完成后，直接呼叫该 Skill 的名称或使用 /flashformat 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

Initial release of flashformat-local-converters skill. - Provides five standalone Python scripts for local format conversion: yaml-to-json, json-to-yaml, markdown-to-text, json-minify, and yaml-auto-fix. - Designed for offline use, CI pipelines, or batch processing without relying on the FlashFormat API. - Supports unified command-line options for flexible input and output handling. - Implements both plain text and structured JSON output modes. - Includes detailed usage instructions and script functionality map.

元数据

Slug flashformat

版本 1.0.0

许可证 —

累计安装 0

当前安装数 0

历史版本数 1

常见问题

flashformat 是什么？

Provide five repository-local format conversion scripts (yaml-to-json, json-to-yaml, markdown-to-text, json-minify, yaml-auto-fix) for offline CLI and pipeli... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 343 次。

如何安装 flashformat？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install flashformat」即可一键安装，无需额外配置。

flashformat 是免费的吗？

是的，flashformat 完全免费（开源免费），可自由下载、安装和使用。

flashformat 支持哪些平台？

flashformat 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 flashformat？

由 GreatHato（@phantom5125）开发并维护，当前版本 v1.0.0。