Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Thanks for your interest in contributing a skill.

**Start with the skill-building skill.** The fastest path to a submission-ready skill is [Build a New Skill](https://skillshelf.ai/skills/write-skill/). Upload it to Claude or ChatGPT, describe the task you want to automate, and it produces a complete skill directory that follows all SkillShelf conventions. You should still review and manually edit the output -- especially for technical skills or skills that require specific platform conventions -- but it handles the structure and boilerplate so you can focus on the domain expertise.
**Start with the skill-building skill.** The fastest path to a submission-ready skill is [Build a New Skill](https://skillshelf.ai/skills/write-skill/). Upload it to Claude or ChatGPT, describe the task you want to automate, and it produces a complete skill directory that follows all SkillShelf conventions. You should still review and manually edit the output (especially for technical skills or skills that require specific platform conventions), but it handles the structure and boilerplate so you can focus on the domain expertise.

If you already have a working prompt or skill file, use [Share a Skill You Already Have](https://skillshelf.ai/skills/adapt-skill/) to convert it into SkillShelf format.

Expand Down Expand Up @@ -168,7 +168,7 @@ After CI passes, the SkillShelf team reviews your skill for quality and safety.
- [ ] `skillshelf.yaml` has all required fields (`version`, `category`, `level`, `primitive`, `platforms`, `tags`)
- [ ] Category is one of the valid values listed above
- [ ] Example output files use fictional brand names, not real ones (see [Skill Authoring Guide](skill-authoring-guide.md) Section 6)
- [ ] You have tested the skill with real inputs and the output is consistently usable -- the [`fixtures/`](fixtures/) directory has sample Shopify exports, PDPs, reviews, and brand content with intentional data quality issues for testing edge cases
- [ ] You have tested the skill with real inputs and the output is consistently usable. The [`fixtures/`](fixtures/) directory has sample Shopify exports, PDPs, reviews, and brand content with intentional data quality issues for testing edge cases.
- [ ] No confidential or personal data is included in the skill or examples

## Platform-specific skills
Expand Down
10 changes: 5 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,11 +64,11 @@ Every skill on SkillShelf goes through a certification review before it is publi

## Reference

- [SKILL.md Specification](skillmd-specs.md) -- format, frontmatter fields, validation rules
- [Skill Authoring Guide](skill-authoring-guide.md) -- best practices for writing effective skills
- [Glossary Specification](glossary-specification.md) -- how to write glossaries for downstream skill consumption
- [Contributing Guide](CONTRIBUTING.md) -- submission process, PR requirements, metadata reference
- [Agent Skills open standard](https://agentskills.io) -- the cross-platform format SkillShelf skills are built on
- [SKILL.md Specification](skillmd-specs.md): format, frontmatter fields, validation rules
- [Skill Authoring Guide](skill-authoring-guide.md): best practices for writing effective skills
- [Glossary Specification](glossary-specification.md): how to write glossaries for downstream skill consumption
- [Contributing Guide](CONTRIBUTING.md): submission process, PR requirements, metadata reference
- [Agent Skills open standard](https://agentskills.io): the cross-platform format SkillShelf skills are built on

## License

Expand Down
36 changes: 18 additions & 18 deletions fixtures/greatoutdoorsco/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,32 +18,32 @@ These fixtures provide standardized, synthetic inputs for testing AI workflows s
| `google-merchant-feed.xml` | Google Merchant Center XML feed (variant-level items). |
| `product-attributes.csv` | Flat attribute/value pairs per product handle. |
| `product-taxonomy.json` | Category tree with product counts. |
| `about-us.md` | About Us / brand story page -- founder origin, design philosophy, product line overview. |
| `homepage.md` | Full homepage content by section -- hero, categories, products, brand story, journal, email capture. |
| `pdp-apparel.md` | Clean, well-written PDP -- Cascade Rain Shell (Women's). |
| `pdp-gear.md` | Technical, spec-heavy PDP -- Cedar Ridge 45L Trek Pack. |
| `pdp-minimal.md` | Sparse PDP with almost no detail -- Ridgeline Hiking Socks. |
| `pdp-messy.md` | Messy/migrated PDP -- HTML artifacts, duplicated paragraphs, keyword stuffing. |
| `yotpo-reviews.csv` | Yotpo-format product reviews export -- 50 reviews across 3 products (Cascade Rain Shell, Cedar Ridge 45L Trek Pack, Alpine Meadow 2P Tent). Includes ratings, review text, tags, sentiment scores, reviewer metadata, and a custom `cf_hiking_experience_level` field. |
| `greatoutdoorsco-tailwind.css` | Tailwind CSS stylesheet -- design tokens (CSS custom properties), component classes, and utility layers for the storefront. |
| `about-us.md` | About Us / brand story page covering founder origin, design philosophy, and product line overview. |
| `homepage.md` | Full homepage content by section (hero, categories, products, brand story, journal, email capture). |
| `pdp-apparel.md` | Clean, well-written PDP for the Cascade Rain Shell (Women's). |
| `pdp-gear.md` | Technical, spec-heavy PDP for the Cedar Ridge 45L Trek Pack. |
| `pdp-minimal.md` | Sparse PDP with almost no detail for the Ridgeline Hiking Socks. |
| `pdp-messy.md` | Messy/migrated PDP with HTML artifacts, duplicated paragraphs, and keyword stuffing. |
| `yotpo-reviews.csv` | Yotpo-format product reviews export with 50 reviews across 3 products (Cascade Rain Shell, Cedar Ridge 45L Trek Pack, Alpine Meadow 2P Tent). Includes ratings, review text, tags, sentiment scores, reviewer metadata, and a custom `cf_hiking_experience_level` field. |
| `greatoutdoorsco-tailwind.css` | Tailwind CSS stylesheet containing design tokens (CSS custom properties), component classes, and utility layers for the storefront. |

## Intentional data quality issues

Several files contain deliberate messiness to test how skills handle real-world data. These are features, not bugs:

- **Mixed weight units** in `product-attributes.csv` -- "11.6 oz" vs "10.9 ounces" vs "3.5 lb"
- **Inconsistent waterproof ratings** -- "15000 mm" vs "15K mm" vs "2000 mm"
- **Duplicate casing in color options** -- "Blue, blue, ORANGE" and "Black, BLUE, blue"
- **Empty/missing values** -- blank warranty, dimensions, and packed_size fields across multiple products
- **Trailing whitespace** -- scattered throughout attribute values
- **Duplicate paragraph** in `pdp-messy.md` -- same block of copy pasted twice
- **HTML artifacts** in `pdp-messy.md` -- raw `<p>`, `<br>`, `<font>` tags from a platform migration
- **Keyword stuffing** in `pdp-messy.md` -- a block of SEO spam at the bottom
- **Inconsistent list formatting** in `pdp-messy.md` -- mixed `-`, `*`, and bare lines
- **Mixed weight units** in `product-attributes.csv`: "11.6 oz" vs "10.9 ounces" vs "3.5 lb"
- **Inconsistent waterproof ratings**: "15000 mm" vs "15K mm" vs "2000 mm"
- **Duplicate casing in color options**: "Blue, blue, ORANGE" and "Black, BLUE, blue"
- **Empty/missing values**: blank warranty, dimensions, and packed_size fields across multiple products
- **Trailing whitespace** scattered throughout attribute values
- **Duplicate paragraph** in `pdp-messy.md` (same block of copy pasted twice)
- **HTML artifacts** in `pdp-messy.md`: raw `<p>`, `<br>`, `<font>` tags from a platform migration
- **Keyword stuffing** in `pdp-messy.md` (a block of SEO spam at the bottom)
- **Inconsistent list formatting** in `pdp-messy.md`: mixed `-`, `*`, and bare lines

## Skill outputs

The `skill-outputs/` directory contains example outputs from SkillShelf skills run against this fixture data. These are useful as inputs to downstream skills -- for example, a product description skill can consume the brand voice profile and positioning brief to produce on-brand copy.
The `skill-outputs/` directory contains example outputs from SkillShelf skills run against this fixture data. These are useful as inputs to downstream skills. For example, a product description skill can consume the brand voice profile and positioning brief to produce on-brand copy.

| File | Produced by | Description |
|------|-------------|-------------|
Expand Down
8 changes: 4 additions & 4 deletions fixtures/greatoutdoorsco/about-us.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,15 @@

We started Great Outdoors Co. because we kept replacing the same gear every year.

We hike most weekends -- not big expeditions, just the trails around the Pacific Northwest that are there rain or shine. And for years we bought the same cheap rain jackets, the same daypacks with zippers that corroded by spring, the same fleece layers that pilled after a dozen washes. We replaced them, bought the same thing again, and repeated the cycle.
We hike most weekends. Not big expeditions, just the trails around the Pacific Northwest that are there rain or shine. And for years we bought the same cheap rain jackets, the same daypacks with zippers that corroded by spring, the same fleece layers that pilled after a dozen washes. We replaced them, bought the same thing again, and repeated the cycle.

The alternative was spending $350 on a jacket designed for alpine mountaineering. Great jacket, wrong customer. We don't need ultralight fabrics or expedition-grade waterproofing. We need gear that handles a rainy Saturday on Tiger Mountain without falling apart by next Saturday.

So we made it ourselves.

## What we make

Great Outdoors Co. makes technical outdoor gear for people who hike and camp most weekends. Rain shells, fleece layers, base layers, packs, tents, sleeping bags, and the accessories that round out a kit. 30 products, no footwear. Everything is designed in the Pacific Northwest, where waterproofing is not a marketing claim -- it's a weekly necessity.
Great Outdoors Co. makes technical outdoor gear for people who hike and camp most weekends. Rain shells, fleece layers, base layers, packs, tents, sleeping bags, and the accessories that round out a kit. 30 products, no footwear. Everything is designed in the Pacific Northwest, where waterproofing is not a marketing claim but a weekly necessity.

We use recycled materials where we can (our shells and packs are recycled nylon, our fleece is recycled polyester), PFAS-free DWR finishes across the line, and RDS-certified down in our insulated pieces. We mention this because it matters to us, not because it's our headline.

Expand All @@ -20,12 +20,12 @@ Most outdoor brands optimize for one of two things: low price or extreme perform

That means we pick fabrics rated for abrasion and durability over grams-per-square-meter weight savings. It means corrosion-resistant hardware instead of ultralight aluminum. It means seam sealing and waterproofing are primary design decisions, not features we add later.

The result is gear that costs more than the budget options and less than the premium ones -- and outlasts both for the way most people actually use it.
The result is gear that costs more than the budget options and less than the premium ones, and outlasts both for the way most people actually use it.

## One option, not twelve

We keep the line simple on purpose. One rain shell, not six. One daypack, not a daypack and an ultralight daypack and a women-specific daypack and a fast-pack. If you hike on weekends, our gear is designed for exactly that. No spec sheet comparisons, no model hierarchies, no wondering if you picked the right one.

## Based in the Pacific Northwest

We design, test, and run the company from the Pacific Northwest. Our gear is tested on the trails we hike -- in the Cascades, the Olympics, and the coast ranges where rain is the baseline condition from October through June. If it works here every weekend, it works anywhere you take it.
We design, test, and run the company from the Pacific Northwest. Our gear is tested on the trails we hike: the Cascades, the Olympics, and the coast ranges where rain is the baseline condition from October through June. If it works here every weekend, it works anywhere you take it.
14 changes: 7 additions & 7 deletions fixtures/greatoutdoorsco/homepage.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Great Outdoors Co. -- Homepage Content
# Great Outdoors Co. Homepage Content

This file contains the text content for the Great Outdoors Co. homepage, organized by section. Each section includes the copy, character/word counts, and notes on what visual content would accompany it. This follows the standard small-to-mid DTC outdoor brand homepage structure.

Expand Down Expand Up @@ -49,7 +49,7 @@ This file contains the text content for the Great Outdoors Co. homepage, organiz

**CTA button:** Shop the Cascade

**Notes:** Full-width lifestyle image of a hiker on a misty PNW trail wearing the Cascade Rain Shell. Rain visible. No dramatic summit shot -- a realistic Saturday morning trail scene. The image should feel like a photo someone's hiking partner took, not a professional campaign.
**Notes:** Full-width lifestyle image of a hiker on a misty PNW trail wearing the Cascade Rain Shell. Rain visible. No dramatic summit shot. A realistic Saturday morning trail scene. The image should feel like a photo someone's hiking partner took, not a professional campaign.

---

Expand All @@ -70,7 +70,7 @@ Six tiles, 2x3 grid on desktop, stacked on mobile:

---

## 5. Featured Products -- "New This Season"
## 5. Featured Products: "New This Season"

**Section headline:** New this season

Expand Down Expand Up @@ -152,7 +152,7 @@ We make technical outdoor gear for people who hike most weekends but don't ident
| Guarantee | 30-day free returns |
| Shipping | Free shipping over $99 |

**Notes:** Icons paired with short text. Not a testimonial section -- a trust bar. Each item is 30-40 characters.
**Notes:** Icons paired with short text. Not a testimonial section; it is a trust bar. Each item is 30-40 characters.

---

Expand Down Expand Up @@ -200,21 +200,21 @@ We make technical outdoor gear for people who hike most weekends but don't ident

## 11. Footer

**Column 1 -- Shop:**
**Column 1: Shop:**
- Rain Shells
- Fleece & Layers
- Packs
- Tents & Shelter
- Sleeping Bags
- Accessories

**Column 2 -- Support:**
**Column 2: Support:**
- Shipping & Returns
- Sizing Guide
- Care Instructions
- Contact Us

**Column 3 -- Company:**
**Column 3: Company:**
- Our Story
- Journal
- Sustainability
Expand Down
42 changes: 21 additions & 21 deletions fixtures/greatoutdoorsco/skill-outputs/brand-guidelines.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,38 +3,38 @@

## Overview

This file documents the brand colors, typography, and visual styling for Great Outdoors Co. (greatoutdoorsco.com). It was extracted from the site's Tailwind CSS stylesheet. The brand direction is calm, rugged, and premium-functional -- an outdoor DTC aesthetic built around forest greens, natural neutrals, and earthy accents.
This file documents the brand colors, typography, and visual styling for Great Outdoors Co. (greatoutdoorsco.com). It was extracted from the site's Tailwind CSS stylesheet. The brand direction is calm, rugged, and premium-functional, an outdoor DTC aesthetic built around forest greens, natural neutrals, and earthy accents.

## Brand Guidelines

### Colors

**Main Colors:**
- Dark: `#1c221f` -- Primary text and dark foreground elements. A deep forest-tinged near-black.
- Soft Text: `#4e5852` -- Body text and secondary copy. A muted dark olive-gray.
- Faint Text: `#707974` -- Tertiary text, labels, and metadata. A quiet sage gray.
- Background: `#f8f7f3` -- Page background. A warm off-white with a slight cream undertone.
- Surface: `#fffffc` -- Cards, panels, and elevated containers. Nearly pure white.
- Surface Muted: `#f2f0e9` -- Subtle backgrounds, badges, and trust bar items. A soft cream.
- Surface Deep: `#e6ebe7` -- Image placeholders and deeper surface areas. A light sage.
- Dark: `#1c221f`. Primary text and dark foreground elements. A deep forest-tinged near-black.
- Soft Text: `#4e5852`. Body text and secondary copy. A muted dark olive-gray.
- Faint Text: `#707974`. Tertiary text, labels, and metadata. A quiet sage gray.
- Background: `#f8f7f3`. Page background. A warm off-white with a slight cream undertone.
- Surface: `#fffffc`. Cards, panels, and elevated containers. Nearly pure white.
- Surface Muted: `#f2f0e9`. Subtle backgrounds, badges, and trust bar items. A soft cream.
- Surface Deep: `#e6ebe7`. Image placeholders and deeper surface areas. A light sage.

**Border Colors:**
- Default: `#d2d7d0` -- Standard borders, dividers, and card outlines. A light warm gray.
- Strong: `#a8b1ab` -- Emphasized borders on hover and interactive states. A medium sage gray.
- Default: `#d2d7d0`. Standard borders, dividers, and card outlines. A light warm gray.
- Strong: `#a8b1ab`. Emphasized borders on hover and interactive states. A medium sage gray.

**Accent Colors:**
- Forest: `#344d40` -- Primary accent, CTAs, buttons, and brand identity color. A deep muted green.
- Forest Deep: `#23352c` -- Hover states on primary buttons, announcement bars. Darker forest.
- Moss: `#687d5e` -- Feature bullets, kicker lines, and secondary green accents. An earthy moss green.
- Rain: `#5d717e` -- Focus rings, badge variants, and cool-toned accents. A slate blue-gray.
- Rain Deep: `#3e505b` -- Rain badge text and deeper blue-gray applications.
- Clay: `#8e6148` -- "New" badge text and warm accent. A muted terracotta.
- Gold: `#a68a56` -- "New" badge backgrounds (at 16% opacity) and warm highlights. A dusty gold.
- Forest: `#344d40`. Primary accent, CTAs, buttons, and brand identity color. A deep muted green.
- Forest Deep: `#23352c`. Hover states on primary buttons, announcement bars. Darker forest.
- Moss: `#687d5e`. Feature bullets, kicker lines, and secondary green accents. An earthy moss green.
- Rain: `#5d717e`. Focus rings, badge variants, and cool-toned accents. A slate blue-gray.
- Rain Deep: `#3e505b`. Rain badge text and deeper blue-gray applications.
- Clay: `#8e6148`. "New" badge text and warm accent. A muted terracotta.
- Gold: `#a68a56`. "New" badge backgrounds (at 16% opacity) and warm highlights. A dusty gold.

**Status Colors:**
- Success: `#436650` -- Positive feedback and confirmation states.
- Warning: `#966f41` -- Caution states and alerts.
- Danger: `#804538` -- Error states and sale badges.
- Success: `#436650`. Positive feedback and confirmation states.
- Warning: `#966f41`. Caution states and alerts.
- Danger: `#804538`. Error states and sale badges.

### Typography

Expand All @@ -50,7 +50,7 @@ This file documents the brand colors, typography, and visual styling for Great O
- H1 and H2: Source Serif 4 (display font), `font-medium` weight, `tracking-tight`
- H1: 2.25rem (mobile), 3rem (desktop)
- H2: 1.875rem (mobile), 2.25rem (desktop)
- H3: 1.5rem (mobile), 1.875rem (desktop) -- uses DM Sans (body font), not the display serif
- H3: 1.5rem (mobile), 1.875rem (desktop). Uses DM Sans (body font), not the display serif
- Hero titles, product titles (XL), journal titles, and review quotes also use Source Serif 4
- Body text, nav links, buttons, badges, and all other UI elements: DM Sans
- Kickers and labels use DM Sans at `font-semibold` with wide letter spacing (0.16em)
Expand Down
Loading
Loading