← Back to Skills Marketplace
phantom5125

flashformat

by GreatHato · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
343
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install flashformat
Description
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...
README (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

  1. Install runtime dependency: python -m pip install PyYAML
  2. Run any converter script with one input channel: --input or --input-file or stdin
  3. Choose output mode: plain text (default) or --json
  4. 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.

Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
✓ 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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install flashformat
  3. After installation, invoke the skill by name or use /flashformat
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Slug flashformat
Version 1.0.0
License —
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 343 downloads so far.

How do I install flashformat?

Run "/install flashformat" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is flashformat free?

Yes, flashformat is completely free (open-source). You can download, install and use it at no cost.

Which platforms does flashformat support?

flashformat is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created flashformat?

It is built and maintained by GreatHato (@phantom5125); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments