file-save-protocol

Save analysis results as JSON and Markdown artifacts at a fixed output path.

Updated Jan 22, 2026
One-click install
npx skills add https://github.com/ByungJu-Lim/obsidian-- --skill file-save-protocol-byungju-lim
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-save-protocol
Source: https://github.com/ByungJu-Lim/obsidian--/tree/main/0-Projects/honeypot-main/honeypot-main/plugins/investments-portfolio/skills/file-save-protocol
Command: npx skills add https://github.com/ByungJu-Lim/obsidian-- --skill file-save-protocol-byungju-lim

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This protocol guarantees that every analysis result is saved as a persistent artifact, eliminating data loss and reducing hallucination risk.

Core Features & Use Cases

  • Deterministic file saving: always uses the coordinator-provided output_path and a fixed filename convention to ensure reproducible artifacts.
  • Dual artifacts for auditing: stores both a structured JSON result and a human-readable Markdown summary.
  • Enforced error handling: includes explicit success/fail responses to prevent silent failures and enable traceability.

Quick Start

Use the Write tool to save the analysis result JSON to the designated output_path and generate a Markdown summary.

Frequently Asked Questions about file-save-protocol

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

FAQPage Schema
How do I ensure my analysis outputs are saved as persistent JSON and Markdown files?

To ensure persistent analysis outputs, use a deterministic protocol that writes a mandatory JSON artifact and a Markdown summary to a designated output path. This enforces fixed naming conventions and validates successful writes to prevent data loss and hallucination.

Why does my analysis result fail to save to the output path without throwing an error?

Silent save failures happen when write operations lack enforced error handling. A deterministic saving protocol validates successful file writes and reports failures explicitly, preventing data loss by ensuring the JSON artifact and Markdown summary are confirmed at the specified output path.

What is the best way to audit analysis results stored as JSON artifacts?

The best way to audit JSON analysis artifacts is to generate a corresponding human-readable Markdown summary alongside the structured data. This dual-artifact approach enforces traceability and verifies that files are saved correctly using fixed path conventions.

Does deterministic file saving prevent hallucination in analysis outputs?

Deterministic file saving prevents hallucination by enforcing a strict protocol that stores analysis results as persistent JSON and Markdown artifacts at a coordinator-provided output path. Validating successful writes eliminates ambiguous states and confirms the exact saved output.

When do I need a fixed naming convention for saving analysis outputs?

You need a fixed naming convention when reproducible artifacts are required for auditing. Enforcing fixed paths and filenames guarantees that every analysis result is stored deterministically at the coordinator-provided output path, preventing misplacement and data loss.