portfolio-showcase - SKILL.md Agent Skill

name: portfolio-showcase description: Organize and showcase creative work. Auto-generate case studies, client rosters, project pages, and portfolio updates. Use when adding projects, creating case studies, updating coltonbatts.com, or generating marketing assets from past work. metadata: {"clawdbot":{"emoji":"🎨"}}

Portfolio & Showcase Skill

Automate the creation and management of your creative portfolio. This skill transforms raw project data into polished case studies, client rosters, and portfolio pages—removing the friction between finishing work and showcasing it.

What This Skill Does

Add new projects — Capture project details and auto-generate case studies
Update coltonbatts.com — Sync projects to your live portfolio
Generate client rosters — Create "Featured Clients" pages (Google, Kate Spade, Under Armour, etc.)
Create marketing assets — Extract key stats, testimonials, and visuals for LinkedIn, email, proposals
Generate PDFs — Professional case study PDFs for client pitches
Organize by type — Tag projects (video, design, direction, branding) and filter/sort automatically

When to Use

"Add a new case study to my portfolio"
"Update my portfolio with the Google project"
"Generate a client roster page"
"Create a PDF case study from my work"
"Make a featured clients slide for my pitch deck"
"Show me all video production work"
"Create a case study for the Kate Spade project"
"Update coltonbatts.com with new projects"

Project Data Structure

Projects are stored as JSON or markdown in {baseDir}/assets/projects/. Each project needs:

{
  "id": "google-campaign-2023",
  "title": "Google Brand Campaign",
  "client": "Google",
  "year": 2023,
  "duration": "3 months",
  "role": "Lead Video Producer & Creative Director",
  "services": ["video-production", "creative-direction", "motion-graphics"],
  "challenge": "Create a compelling brand campaign showcasing Google's commitment to accessibility.",
  "solution": "Developed a multi-platform video series with compelling narratives, working with diverse creators.",
  "results": [
    "15M+ views across platforms",
    "82% positive sentiment in comments",
    "Featured on Google's homepage"
  ],
  "mediaUrl": "https://youtube.com/watch?v=...",
  "thumbnailUrl": "path/to/thumbnail.jpg",
  "featured": true,
  "tags": ["video", "direction", "commercial"],
  "testimonial": "Colton delivered exceptional creative vision. Working with him elevated our entire campaign.",
  "testimonialAuthor": "Jane Smith, Google Creative Lead"
}

See references/portfolio-schema.json for the full data model.

Quick Start

Step 1: Add a New Project

Provide project details in any format:

Natural language: "Add a project: I made a video for Kate Spade called 'The New Collection' in 2022. It was shot over 2 weeks, it's about product photography and motion design, we got 2.3M views."
JSON: Copy the structure above and fill in details
Markdown: Use the template in references/case-study-template.md

Step 2: Generate Case Study

Once a project is logged, I'll automatically:

Create a formatted case study (Markdown + HTML)
Extract key visuals and metadata
Generate an optimized summary for social/email
Save to projects/<project-id>/case-study.html

Step 3: Update Portfolio Website

Command: "Update coltonbatts.com with my latest projects"

I'll:

Scan all projects in assets/projects/
Generate an updated portfolio index
Create individual project pages
Format for easy integration into coltonbatts.com

Step 4: Create Marketing Assets

Generate variations:

LinkedIn post — Short version with key metrics
Email summary — Client-ready 2-3 paragraph version
Pitch deck slide — One-page visual summary
PDF case study — Professional 3-5 page document

Project Organization

Projects are organized by service type:

video-production — Commercials, promos, documentaries, branded content
creative-direction — Art direction, creative strategy, concept development
motion-graphics — Animation, graphics, visual effects
design — Graphic design, branding, visual identity
photography — Product shots, lifestyle, editorial

Tag projects with multiple types as needed.

Case Study Format

Each case study includes:

Header — Project title, client, year, role
Challenge — The problem or brief
Solution — Your approach and execution
Results — Measurable outcomes (views, engagement, client feedback)
Media — Hero image/video with caption
Testimonial — Client or collaborator quote (optional)
Services — What you did (video, design, direction, etc.)

See references/case-study-template.md for full template.

Updating Existing Projects

To modify a project:

"Update the Google project: change duration to '4 months'"
"Add a testimonial to the Kate Spade case study"
"Mark the Under Armour project as featured"

I'll update the JSON and regenerate all associated files.

Listing Projects

"Show me all my projects"
"Show me featured projects"
"Show me video production work"
"Show me projects from 2023"
"Show me projects for the Alternative Design portfolio"

Filtering & Sorting

Projects can be filtered by:

Service type: video, design, motion, direction
Year: chronological or reverse-chronological
Client: specific client or all
Status: featured vs. all
Duration: recent projects vs. archive

Example Workflow

User: "Add the Under Armour project to my portfolio"

I'll respond:
"Got it. To create a case study, I need a few details:
1. Project title
2. When did you make it? (year/duration)
3. Your role
4. What was the challenge or brief?
5. What was your solution/approach?
6. Any measurable results? (views, engagement, feedback)
7. Media link? (YouTube, Vimeo, image URL)
8. Client testimonial? (optional)"

User provides details, I generate:
✓ case-study.md
✓ case-study.html
✓ project-meta.json
✓ LinkedIn post version
✓ Email summary version

And suggest: "Ready to update coltonbatts.com with this project?"

File Structure

After using this skill, you'll have:

/Users/coltonbatts/clawd/skills/portfolio-showcase/
├── assets/
│   ├── projects/
│   │   ├── google-campaign-2023/
│   │   │   ├── case-study.html
│   │   │   ├── case-study.md
│   │   │   ├── project-meta.json
│   │   │   ├── thumbnail.jpg
│   │   │   └── social-versions.md
│   │   ├── kate-spade-new-collection/
│   │   │   ├── case-study.html
│   │   │   ├── ...
│   │   └── projects-index.json
│   └── portfolio-templates/
│       ├── case-study.html
│       ├── portfolio-page.html
│       └── featured-clients.html
├── references/
│   ├── case-study-template.md
│   └── portfolio-schema.json
├── scripts/
│   ├── add-project.py
│   ├── generate-case-study.py
│   └── sync-portfolio.py
└── SKILL.md

Integration with coltonbatts.com

Once you have projects organized in this skill, updating your live website is one command: "Update coltonbatts.com with my latest projects"

This generates:

Updated portfolio index page
Individual project pages
Featured clients section
Project filtering/search
Mobile-responsive layouts

The generated HTML can be directly integrated into your website.

Tips for Great Case Studies

Specific results — "2.3M views" beats "lots of engagement"
Client voice — Testimonials add credibility
Visual proof — Always include media (video, image, or link)
Your role — Be clear what you did specifically
Challenge > Solution > Results — Tell the story in three acts

Maintenance

Review and update projects quarterly
Mark completed projects as "featured" for current pitching
Archive old projects (keep for historical reference)
Refresh coltonbatts.com when you add 2-3 new projects

Next Steps

Start by adding your flagship projects (Google, Kate Spade, Under Armour)
Generate case studies for each
Update coltonbatts.com
Use the social versions for LinkedIn, email, pitches
Monitor engagement and iterate

Use this skill proactively—every completed project should become a case study within a week.