add-reference

Add Juice Shop references to REFERENCES.md with metadata and formatting.

Updated May 14, 2026
One-click install
npx skills add https://github.com/VitorM147/juice-shop-private --skill add-reference-vitorm147
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-reference
Source: https://github.com/VitorM147/juice-shop-private/tree/main/.ai/skills/add-reference
Command: npx skills add https://github.com/VitorM147/juice-shop-private --skill add-reference-vitorm147

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill removes the guesswork and formatting errors involved in adding a new Juice Shop-related blog post, talk, or other reference to the project’s REFERENCES.md in the correct place.

Core Features & Use Cases

  • Reference vs. Solution decisioning: Determines whether the input belongs in REFERENCES.md or SOLUTIONS.md based on whether the content is a general mention/appearance versus a how-to or hacking walkthrough.
  • Metadata harvesting: Extracts title, author/speaker, date, event/podcast/blog name, and optional video links by fetching and reviewing the provided URL(s).
  • Accurate placement and formatting: Selects the correct supported reference type (podcast, blog, lecture, summit, GSoC, conference, award, tools) and formats the entry consistently, including ordering by year for appearances.
  • Table of contents updates: Updates the Table of Contents when a new year section is introduced for conference and meetup appearances.

Quick Start

Ask the skill to add a reference by providing the URL of the blog post or talk and the available author/title/date details, and it will return the correctly formatted entry for REFERENCES.md.

Frequently Asked Questions about add-reference

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

FAQPage Schema
How do I format and add a new Juice Shop reference to the correct markdown file?

To add a Juice Shop reference, the Skill analyzes the provided URL to harvest metadata like author and date, then deterministically formats the entry into either REFERENCES.md or SOLUTIONS.md based on the content type.

How does the tool decide whether a Juice Shop mention goes into REFERENCES.md or SOLUTIONS.md?

The tool distinguishes between general mentions, appearances, and awards for REFERENCES.md versus how-to hacking walkthroughs and guides, which are routed to SOLUTIONS.md, ensuring accurate content categorization.

Can I automatically extract metadata like title and date from a blog post URL for my references?

Yes, the Skill harvests metadata by fetching and reviewing the provided URL to extract the title, author or speaker, date, event name, and optional video links for the reference entry.

How do I update the Table of Contents when adding a new year section to markdown references?

When adding conference or meetup appearances that introduce a new year-based section, the Skill automatically updates the Table of Contents in the markdown file to maintain documentation consistency.

What types of Juice Shop references are supported for deterministic markdown formatting?

Supported reference types include blog posts, podcasts, lectures, summit and conference appearances, awards, GSoC projects, and tool or product usage mentions, each with specific formatting rules.

Does adding a conference appearance require manual placement in the correct year-based section?

No, the Skill infers the correct reference type and automatically inserts the formatted entry into the correct year-based section within the markdown file without manual placement.