Skip to content

quinntynebrown/photoshoot-map

v0.1.0MIT

Create illustrated photoshoot maps with numbered shooting spots, routes, and lens and lighting notes for outdoor, indoor, and client-facing sessions.

GitHubOpen Website

Photoshoot Map

An Agent Skill that creates illustrated PNG photoshoot maps from a location or supplied site plan. Maps combine numbered shooting spots, a practical route, and scene-specific lens and lighting notes. Outdoor locations, indoor venues, multiple floors, detail maps, and client-facing versions are supported.

Illustrative photoshoot map style sample

Retained style sample from the original skill. Its geography, route arrows, timing, and camera settings are illustrative; they are not a verified current shoot plan.

Quick Start

From a local checkout:

npx skills add ./

Once this repository is available on GitHub:

npx skills add QuinntyneBrown/photoshoot-map

Copy-based installation also works: copy the entire skills/photoshoot-map directory into your agent's skills directory. Keep its references, assets, and agent metadata together.

The host agent needs web research, image viewing, built-in image generation/editing, and permission to save PNG files. PDF venue plans require PDF viewing/rendering. Installing the skill supplies instructions and assets; it does not supply these host capabilities.

Native Plugin Packaging

This repository includes plugin manifests for Claude Code, Codex, and GitHub Copilot, plus a root plugin manifest and skills registry metadata. The repository-local marketplaces point to the plugin at the repository root.

For Claude Code, after publishing the repository:

/plugin marketplace add QuinntyneBrown/photoshoot-map
/plugin install photoshoot-map@quinntynebrown-photoshoot-map

For Codex, use the repository's .agents/plugins/marketplace.json as the marketplace catalog. Installation UI and commands depend on the host version. This project has not been submitted to any third-party marketplace.

Then Ask

Use $photoshoot-map to create an illustrated photoshoot map for J.C. Saddington Park for a small family portrait session.

Other useful requests:

  • “Create client-facing maps for the publicly accessible floors of Casa Loma.”
  • “Use this supplied floor plan to map a 45-minute indoor portrait session.”
  • “Create photographer and client versions from the same stops.”
  • “Make a 2× detail map around the pond, preserving the original layout.”

A location alone is enough to start when it can be identified. Date/time, session length, audience, lenses, lighting gear, mobility needs, and output destination are optional.

What to Expect

The skill researches geography and relevant photography rules, plans stops, renders each requested sheet, inspects it, and saves final PNGs. Photographer maps include lens/framing and lighting notes at every stop. Client maps use a compact spot key and omit photographer instructions.

Without a supplied date/time, lighting notes describe useful conditions rather than invented clock times. Indoor maps use verified floors and connections; a schematic is identified as such when adjacency cannot be verified.

By default, outputs are saved under output/photoshoot-maps/<location-slug>/ in the active workspace. The delivery includes clickable PNG links, sources, and material assumptions. If the host cannot generate images, the skill explains the limitation and retains a concrete plan and render specification.

See the Markdown example, HTML example, and how it works.

Contributing

  1. Make changes in skills/photoshoot-map/ and update affected documentation.
  2. Check discovery with npx skills add ./ --list.
  3. Run the validation steps in .github/workflows/ci.yml.
  4. For behavior changes, use the example scenarios and inspect actual saved maps. Report what was exercised.
  5. Keep versions aligned across skill metadata and plugin/marketplace manifests; record changes in CHANGELOG.md.

There is no application build. CI validates packaging and documentation; it does not prove geography or image-generation quality. Read AGENTS.md before contributing.

Credits and License

The repository layout and packaging are adapted from johnpapa/ai-ready, inspected at commit ab8aed2aaefb186061cd7549daefad0248598636. Its MIT notice is retained in LICENSE.

Skill instructions, references, agent metadata, and the style image originate from the author's existing photoshoot-map skill. The bundled image retains its displayed map-data attribution.

MIT. See SECURITY.md for reporting guidance.