# File Reference

> Process and analyze user-uploaded file references, extract key information, and provide application recommendations. Suitable for parsing @symbol references, natural language references, and extracting vertical short drama planning information Use when this capability is needed.

- Skill: `tomevault-io/file-reference` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/file-reference`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/file-reference/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/file-reference

---


# File Reference Parsing Expert

## Functionality

Process and analyze user-uploaded file references, extract key information, and provide structured output with application recommendations.

## Usage Scenarios

- Parse local files or URL links referenced by users in conversations
- Extract core information from files to support agent understanding and utilization of file content
- Provide file content application recommendations for short drama planning to assist creation
- Automate processing of various file references to improve workflow efficiency

## Supported Reference Formats

### @Symbol References
- `@file1` - Document file reference
- `@image1` - Image file reference
- `@pdfDocument` - PDF document reference

### Natural Language References
- "First file", "Second file" - Sequential references
- "Most recently uploaded file" - Time-based references
- "That image file" - Type-based references

## Core Capabilities

- **File Reference Parsing**: Accurately identify and parse various file reference formats (@symbols, natural language)
- **Content Extraction**: Extract key information and core content from referenced files
- **Structured Output**: Present file content in a structured format for easy understanding and utilization
- **Application Recommendations**: Provide specific application recommendations for short drama planning based on file content

## Input Requirements

- **File Reference**: File reference provided by user (e.g., `@draft.docx` or "the image just uploaded")
- **Analysis Requirements** (optional): Specify specific information to extract from the file or analysis focus

## Output Format

```
## File Reference Analysis Report

### Reference Summary
- Reference Type: [@symbol reference/natural language reference]
- File Type: [document/image/PDF/other]
- File Name: [file name]

### File Content Overview
[Briefly describe the main content and core information of the file]

### Key Information Extraction
1. [Key information point 1]
2. [Key information point 2]
3. [Key information point 3]

### Short Drama Planning Application Recommendations
1. **Character Design**: [How to use for character role design]
2. **Plot Design**: [How to use for plot structure planning]
3. **Commercialization**: [How to use for commercial element design]
```

## Constraints

- Ensure accuracy and comprehensiveness of file content analysis
- Focus on content relevant to vertical short drama planning, avoid irrelevant information
- Provide specific, actionable application recommendations to assist user creation decisions
- Avoid introducing any hallucinations or false information in output

## Examples

See `{baseDir}/references/examples.md` for more detailed examples:
- `examples.md` - Contains detailed examples of reference parsing and application recommendations for various file types (documents, images, PDFs, etc.)

## Detailed Documentation

See `{baseDir}/references/examples.md` for detailed guidance and cases on file reference parsing.

---

## Version History

| Version | Date | Changes |
|---------|------|---------|
| 2.1.0 | 2026-01-11 | Optimized description field; changed model to opus; optimized descriptions for functionality, supported reference formats, core capabilities, input requirements, and output format; added usage scenarios, constraints, examples, and detailed documentation sections |
| 2.0.0 | 2026-01-11 | Restructured according to official specifications |
| 1.0.0 | 2026-01-10 | Initial version |

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/gonglingrui) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->