Context Bundling Skill 📦

Overview

🎯 Primary Directive

1. Complete: Contains all required dependencies, documentation, and source code.
2. Ordered: Flows logically (Identity/Prompt → Manifest → Design Docs → Source Code).
3. Annotated: Every file must include a brief note explaining its purpose in the bundle.

Core Workflow: Generating a Bundle

1. Analyze the Intent

• Code Review: Include implementation files and overarching logic.
• Red Team / Security: Include architecture diagrams and security protocols.
• Bootstrapping: Include

  README

  ,

  .env.example

  , and structural scaffolding.

2. Define the Manifest Schema

{
  "title": "Bundle Title",
  "description": "Short explanation of the bundle's goal.",
  "files": [
    {
      "path": "docs/architecture.md",
      "note": "Primary design document"
    },
    {
      "path": "src/main.py",
      "note": "Core implementation logic"
    }
  ]
}

3. Generate the Markdown Bundle

cat

view_file

output.md

# [Bundle Title]
**Description:** [Description]

## Index
1. `docs/architecture.md` - Primary design document
2. `src/main.py` - Core implementation logic

---

## File: `docs/architecture.md`
> Note: Primary design document

\`\`\`markdown
... file contents ...
\`\`\`

---

## File: `src/main.py`
> Note: Core implementation logic

\`\`\`python
... file contents ...
\`\`\`

Conditional Step Inclusion & Error Handling

1. Do not abort the entire bundle.
2. In the final

   output.md

   , insert a placeholder explicitly declaring the failure:
   markdown

   ## File: `missing/file.py`
   > 🔴 **NOT INCLUDED**: The file was not found or could not be read.

3. Proceed bundling the remaining valid files.

Best Practices & Anti-Patterns

1. Self-Contained Functionality: The output file must contain 100% of the context required for a secondary agent to operate without needing to run terminal commands.
2. Specialized Prompts: If bundling for an external review (e.g., a "Red Team" security check), suggest including a specialized prompt file as the very first file in the bundle to guide the receiving LLM.

Common Bundling Mistakes

• Bloat: Including

  node_modules/

  or massive

  .json

  dumps instead of targeted files.
• Silent Exclusion: Filtering out an unreadable file without explicitly declaring it missing (violates transparency).