lore-create-fieldnote

Create structured FIELDNOTE.md files documenting non-obvious operational snags.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/lorehq/lore --skill lore-create-fieldnote
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lore-create-fieldnote
Source: https://github.com/lorehq/lore/tree/main/.lore/harness/skills/lore-create-fieldnote
Command: npx skills add https://github.com/lorehq/lore --skill lore-create-fieldnote

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Fieldnotes capture environmental knowledge from failures — auth quirks, encoding issues, parameter tricks, platform incompatibilities — so teams don't repeat the same surprises.

Core Features & Use Cases

  • Automatic fieldnote creation: Converts failed operations into structured FIELDNOTE.md entries stored under ~/.lore/knowledge-base/fieldnotes/.
  • Standardized format: Each fieldnote uses FIELDNOTE.md as manifest with a controlled 30-80 line content window.
  • Scenarios: Use during authentication quirks, encoding edge cases, and platform-related surprises across development, CI, and production runs.

Quick Start

Create a fieldnote for a non-obvious snag at the designated path under ~/.lore/knowledge-base/fieldnotes/.

Frequently Asked Questions about lore-create-fieldnote

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

FAQPage Schema
How do I document non-obvious snags and platform incompatibilities encountered during development?

Document non-obvious snags by creating a structured fieldnote entry. This converts failed operations like authentication quirks and encoding edge cases into a standardized knowledge-base record stored as a FIELDNOTE.md manifest.

What is the best way to capture environmental knowledge from authentication quirks and encoding edge cases?

Capture environmental knowledge using standardized fieldnotes. This process records specific parameter tricks and platform incompatibilities from failed operations so teams avoid repeating the same surprises across development, testing, and production.

How do I create a fieldnote for a snag, and where is the file stored?

Create a fieldnote by converting the failed operation into a structured entry. The file is automatically stored as FIELDNOTE.md under the designated path at ~/.lore/knowledge-base/fieldnotes/<fieldnote-name>/.

Are there content limits or a required format for documenting troubleshooting knowledge-base entries?

Yes, troubleshooting fieldnotes must follow a standardized format with a controlled content window. Each FIELDNOTE.md entry is enforced to stay within a strict 30-80 line limit to maintain concise environmental knowledge records.

Does this fieldnote approach work for tracking failures across CI and production environments?

Fieldnotes are applicable for tracking failures across CI and production environments. They handle platform-related surprises, authentication quirks, and encoding edge cases encountered during development, testing, and production runs.

Why should I use a standardized fieldnote instead of informal documentation for operational quirks?

Standardized fieldnotes prevent teams from repeating operational surprises. Unlike informal documentation, they enforce a structured 30-80 line FIELDNOTE.md format that reliably captures non-obvious snags for the knowledge-base.