perl-share-files

Access packaged share files in Perl distributions via File::ShareDir APIs.

8|1|Updated Mar 14, 2026
One-click install
npx skills add https://github.com/Getty/p5-app-karr --skill perl-share-files
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: perl-share-files
Source: https://github.com/Getty/p5-app-karr/tree/main/.claude/skills/perl-share-files
Command: npx skills add https://github.com/Getty/p5-app-karr --skill perl-share-files

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

File::ShareDir enables Perl distributions to ship and access non-code data files (templates, schemas, configs, and other share data) at runtime without hard-coding paths or embedding data in code.

Core Features & Use Cases

  • Runtime access to distribution share files via dist_dir, dist_file, module_dir, and module_file.
  • Development fallback patterns to locate share data during development when not installed.
  • Supports use in testing and packaging workflows for templates, schemas, configs, and other data bundled with a distribution.

Quick Start

Install File::ShareDir and start accessing a packaged share file from your distribution.

Frequently Asked Questions about perl-share-files

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

FAQPage Schema
How do I access non-code data files packaged with a Perl distribution at runtime?

Access share files in Perl distributions at runtime using File::ShareDir APIs like dist_dir, dist_file, module_dir, and module_file to locate templates, schemas, and configs without hard-coding paths.

What is the best way to ship templates and config files with a Perl module?

Ship templates and configs with Perl distributions by packaging them as share data and using File::ShareDir to locate them at runtime, keeping non-code data separate from embedded logic.

How do I locate share files during Perl development before a distribution is installed?

Locate share files during development using File::ShareDir development fallback patterns, which find distribution data before installation so testing and packaging workflows function correctly.

Does File::ShareDir work with Dist::Zilla for packaging share data?

File::ShareDir works with Dist::Zilla packaging workflows to bundle and access share data, supporting per-distribution file lookups for templates, schemas, and configs during both development and runtime.

Can I use File::ShareDir to access per-module data files instead of per-distribution files?

Access per-module data files using File::ShareDir's module_dir and module_file APIs, which provide lookups scoped to specific modules rather than the entire distribution.

Why are my Perl distribution share files not found during testing?

Share files are not found during testing when development fallbacks are missing; File::ShareDir provides testing helpers and fallback patterns to locate share data before the distribution is installed.