Large Report Editor

{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-01-21T14:54:15.715Z",
    "slug": "acskamloops-large-report-editor",
    "source_url": "https://github.com/ACSKamloops/shs-engine/tree/master/.codex/skills/large-report-editor",
    "source_ref": "master",
    "model": "claude",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "c567b2e6065fe911ade867fb6617d26f39c3fda4038c964f914363936424e2f4",
    "tree_hash": "00e1ac8b21aeb900be89de665797c8da9c62cf4672c5297467d99809bee89c1a"
  },
  "skill": {
    "name": "large-report-editor",
    "description": "Edits and compiles very large Markdown research reports using surgical patches, structure JSON, and legal‑grade citation rules.",
    "summary": "Edits and compiles very large Markdown research reports using surgical patches, structure JSON, and legal-grade citation rules for precise document updates.",
    "icon": "📦",
    "version": "1.0.0",
    "author": "ACSKamloops",
    "license": "MIT",
    "tags": [
      "markdown",
      "report-editing",
      "document-processing",
      "research",
      "citations"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "network",
      "filesystem",
      "external_commands"
    ]
  },
  "security_audit": {
    "risk_level": "safe",
    "is_blocked": false,
    "safe_to_publish": true,
    "summary": "Static analysis detected patterns related to URL references, file paths, and markdown formatting that are false positives. The skill is a document editing tool for Markdown research reports with no actual network calls, file system exploitation, or code execution risks. All detected patterns stem from metadata fields and documentation references.",
    "risk_factor_evidence": [
      {
        "factor": "network",
        "evidence": [
          {
            "file": "skill-report.json",
            "line_start": 6,
            "line_end": 6,
            "description": "Source URL metadata field for skill attribution, not network call"
          }
        ]
      },
      {
        "factor": "filesystem",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 7,
            "line_end": 7,
            "description": "Documentation references to Archive backup directory for file operations"
          }
        ]
      },
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 7,
            "line_end": 7,
            "description": "Markdown backtick formatting for file paths in documentation"
          },
          {
            "file": "SKILL.md",
            "line_start": 8,
            "line_end": 8,
            "description": "Markdown backtick formatting for instruction file references"
          },
          {
            "file": "SKILL.md",
            "line_start": 10,
            "line_end": 10,
            "description": "Markdown backtick formatting for directory paths in documentation"
          }
        ]
      }
    ],
    "critical_findings": [],
    "high_findings": [
      {
        "title": "Weak Cryptographic Algorithm (FALSE POSITIVE)",
        "description": "Static analyzer detected patterns interpreted as weak crypto algorithms. Investigation reveals these are false positives caused by documentation strings containing words like 'StableID' that match crypto-related patterns. The skill does not perform any cryptographic operations.",
        "verdict": "FALSE_POSITIVE",
        "locations": [
          {
            "file": "skill-report.json",
            "line_start": 16,
            "line_end": 16
          },
          {
            "file": "skill-report.json",
            "line_start": 93,
            "line_end": 93
          },
          {
            "file": "skill-report.json",
            "line_start": 104,
            "line_end": 104
          },
          {
            "file": "skill-report.json",
            "line_start": 115,
            "line_end": 115
          },
          {
            "file": "skill-report.json",
            "line_start": 151,
            "line_end": 151
          },
          {
            "file": "skill-report.json",
            "line_start": 162,
            "line_end": 162
          },
          {
            "file": "SKILL.md",
            "line_start": 3,
            "line_end": 3
          }
        ]
      }
    ],
    "medium_findings": [
      {
        "title": "Ruby/Shell Backtick Execution (FALSE POSITIVE)",
        "description": "Static analyzer detected backtick syntax and flagged as shell execution risk. In context, backticks are used for Markdown code formatting in documentation, not Ruby/shell command execution. No actual backtick operator usage exists in the skill code.",
        "verdict": "FALSE_POSITIVE",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 7,
            "line_end": 7
          },
          {
            "file": "SKILL.md",
            "line_start": 8,
            "line_end": 8
          },
          {
            "file": "SKILL.md",
            "line_start": 10,
            "line_end": 10
          }
        ]
      },
      {
        "title": "Hidden File Access (FALSE POSITIVE)",
        "description": "Documentation references Archive/ directory for backup operations. This is standard file management practice for document editing workflows, not hidden file access exploitation.",
        "verdict": "FALSE_POSITIVE",
        "locations": [
          {
            "file": "skill-report.json",
            "line_start": 6,
            "line_end": 6
          }
        ]
      }
    ],
    "low_findings": [
      {
        "title": "Hardcoded URL (FALSE POSITIVE)",
        "description": "The source_url field in metadata contains a GitHub repository URL. This is standard attribution metadata, not a hardcoded endpoint for data exfiltration or malicious network calls.",
        "verdict": "FALSE_POSITIVE",
        "locations": [
          {
            "file": "skill-report.json",
            "line_start": 6,
            "line_end": 6
          }
        ]
      }
    ],
    "dangerous_patterns": [],
    "files_scanned": 2,
    "total_lines": 225,
    "audit_model": "claude",
    "audited_at": "2026-01-21T14:54:15.715Z"
  },
  "content": {
    "user_title": "Edit Large Research Reports with Precision",
    "value_statement": "Editing very large Markdown research reports is challenging with context loss and citation errors. This skill uses surgical patches, structure JSON, and legal-grade citation rules to update documents safely while preserving all references and page anchors.",
    "seo_keywords": [
      "Claude",
      "Codex",
      "Claude Code",
      "large report editor",
      "Markdown editor",
      "research document editing",
      "citation management",
      "document processing",
      "technical writing",
      "report compilation"
    ],
    "actual_capabilities": [
      "Applies surgical patches to very large Markdown files without losing context",
      "Uses structure JSON to understand document hierarchy and relationships",
      "Implements legal-grade citation rules with StableID and page anchors",
      "Creates automatic backups before major edits in Archive directory",
      "Processes chunked edits with full context preservation"
    ],
    "limitations": [
      "Requires documents to follow standard Markdown formatting conventions",
      "Cannot process encrypted or password-protected documents",
      "Best suited for research reports with formal citation structures",
      "Large files may require multiple edit passes for complex changes"
    ],
    "use_cases": [
      {
        "title": "Update Research Paper Citations",
        "description": "Add, remove, or update citations in a 200-page academic paper while preserving all cross-references and maintaining proper citation numbering throughout the document.",
        "target_user": "Academic researchers and technical writers"
      },
      {
        "title": "Revise Technical Documentation",
        "description": "Make targeted edits to large technical specification documents or API documentation without breaking internal links, code examples, or reference sections.",
        "target_user": "Technical documentation teams"
      },
      {
        "title": "Compile Annual Reports",
        "description": "Merge updates from multiple contributors into a comprehensive annual report while maintaining consistent formatting, table of contents, and cross-references.",
        "target_user": "Corporate communications teams"
      }
    ],
    "prompt_templates": [
      {
        "title": "Basic Report Edit",
        "prompt": "Edit the large report at {file_path} to update section {section_name}. Make the following changes: {list_of_changes}. Ensure all citations and cross-references remain valid.",
        "scenario": "When you need to make specific edits to a named section"
      },
      {
        "title": "Citation Update",
        "prompt": "Update all citations in {file_path} to use the new format: Author (Year). Replace existing citations while preserving StableIDs and page anchors. Report any broken references.",
        "scenario": "When standardizing citation format across a document"
      },
      {
        "title": "Multi-Section Revision",
        "prompt": "Review {file_path} and make surgical edits to sections {section_list}. For each change, apply the surgical patch method, cite new statements with StableID + page anchor, and backup to Archive before saving.",
        "scenario": "When making coordinated edits across multiple sections"
      },
      {
        "title": "Context-Aware Refactoring",
        "prompt": "Refactor the discussion section in {file_path} to improve clarity and flow. Use structure JSON to understand current relationships. Preserve all citations and maintain logical argument structure.",
        "scenario": "When improving document structure while preserving content"
      }
    ],
    "output_examples": [
      {
        "input": "Edit section 3.2 to replace 'methodology was effective' with 'methodology demonstrated statistically significant improvements'",
        "output": "Section 3.2 updated. New text: 'The methodology demonstrated statistically significant improvements [Smith2023, p.45].'\n\nCitation applied with StableID: stable-id-12345\nPrevious text archived to: 99_Working_Files/Archive/section_3_2_backup.md"
      },
      {
        "input": "Add new paragraph after paragraph 5 in the Results section",
        "output": "New paragraph inserted at Results section, paragraph 6.\n\nNew content cited with StableID: stable-id-67890\nTable of contents updated automatically.\nAll cross-references verified intact."
      },
      {
        "input": "Update all instances of 'participants' to 'subjects' except in direct quotes",
        "output": "Updated 47 instances of 'participants' to 'subjects'\nPreserved 3 direct quotes unchanged\nCitation references verified: 12 updated, 5 unchanged\nChanges applied using surgical patch method"
      }
    ],
    "best_practices": [
      "Always work with backups enabled and verify archive creation before major edits",
      "Use structure JSON to understand document hierarchy before making changes",
      "Cite all new content with StableID and page anchors for traceability"
    ],
    "anti_patterns": [
      "Making wholesale replacements of large sections without surgical patches",
      "Editing without creating backups first",
      "Skipping citation rules when adding new content"
    ],
    "faq": [
      {
        "question": "What file sizes can this skill handle?",
        "answer": "The skill is designed for documents over 100 pages. Very large files (500+ pages) may require chunked processing with context management."
      },
      {
        "question": "Does this skill work with PDF files?",
        "answer": "No, this skill operates on Markdown files only. For PDF editing, convert documents to Markdown format first."
      },
      {
        "question": "How does citation preservation work?",
        "answer": "The skill tracks StableIDs and page anchors for each citation. When editing, it verifies citation integrity and reports any broken references."
      },
      {
        "question": "Can I undo changes?",
        "answer": "Yes, all edits create backups in 99_Working_Files/Archive/ before saving. You can restore from these backups if needed."
      },
      {
        "question": "What citation formats are supported?",
        "answer": "The skill supports standard academic citation formats including APA, MLA, Chicago, and custom StableID + anchor notation."
      },
      {
        "question": "Does this skill work with collaborative documents?",
        "answer": "Yes, the skill can process documents with tracked changes. It applies edits as new content while preserving existing change markers."
      }
    ]
  },
  "file_structure": [
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 11
    }
  ]
}