# Main Directories in the Leonxlnx/taste-skill Repository Explained > Explore the main directories in the Leonxlnx/taste-skill repository. Understand how skills research examples assets and github configurations are organized within this codebase. - Repository: [Leon Lin/taste-skill](https://github.com/Leonxlnx/taste-skill) - Tags: architecture - Published: 2026-05-26 --- **The Leonxlnx/taste-skill repository organizes its codebase into five primary directories—`skills/`, `research/`, `examples/`, `assets/`, and `.github/`—each dedicated to specific aspects of skill management, research documentation, visual assets, and GitHub configuration.** Understanding the repository structure is essential for navigating the Leonxlnx/taste-skill project effectively. This open-source repository groups functionality into distinct top-level folders that separate skill definitions from research notes and supporting materials. The following guide breaks down the main directories in the Leonxlnx/taste-skill repository and explains how to interact with each component. ## Overview of the Top-Level Structure The repository root contains five functional directories alongside critical configuration files. The **`skills/`** directory houses the core skill implementations, while **`research/`** maintains analytical documentation. Supporting materials reside in **`examples/`** and **`assets/`**, and **`.github/`** manages CI/CD workflows and community health files. ## The Five Main Directories ### skills/ The **`skills/`** directory contains individual skill definitions, each residing in its own subfolder. Every skill includes a [`SKILL.md`](https://github.com/Leonxlnx/taste-skill/blob/main/SKILL.md) file describing behavior and configuration parameters. For example, `skills/taste-skill/` holds the primary taste skill implementation, while sibling folders like `stitch-skill` and `imagegen-frontend-web` provide complementary capabilities. ### research/ The **`research/`** directory archives analysis, design notes, and exploratory findings. Subdirectories organize content by topic, such as [`research/laziness/remediation/parameter-tuning.md`](https://github.com/Leonxlnx/taste-skill/blob/main/research/laziness/remediation/parameter-tuning.md) for laziness mitigation strategies. This folder serves as the project's knowledge base for architectural decisions and optimization studies. ### examples/ Visual demonstrations live in the **`examples/`** directory, typically containing `.webp` assets that illustrate skill outputs. These files provide concrete references for expected generative results across different skill implementations. ### assets/ Static media for documentation inhabits the **`assets/`** folder, including logos and banners referenced by the main [`README.md`](https://github.com/Leonxlnx/taste-skill/blob/main/README.md). These resources support the repository's visual identity and branding materials. ### .github/ GitHub-specific configurations reside here, including funding information, workflow definitions, and Copilot instructions. This directory standardizes repository automation and community interaction protocols. ## Working with the Repository Structure ### Listing Available Skills To enumerate all skills in the repository: ```bash # From the repository root for skill in skills/*; do echo "Skill: $(basename "$skill")" done ``` ### Executing Skills Locally The **[`skill.sh`](https://github.com/Leonxlnx/taste-skill/blob/main/skill.sh)** helper script enables local skill invocation: ```bash ./skill.sh run taste-skill "Generate a minimalist design for a coffee shop logo" ``` Replace `taste-skill` with any subdirectory under `skills/` to execute alternative implementations. ### Accessing Documentation View skill specifications using standard Unix tools: ```bash less skills/stitch-skill/SKILL.md ``` For research insights, target specific analysis files: ```bash cat research/laziness/remediation/parameter-tuning.md ``` ## Root-Level Configuration Files Beyond the main directories, the repository includes several critical files: - **[`README.md`](https://github.com/Leonxlnx/taste-skill/blob/main/README.md)**: Project overview and usage instructions - **`LICENSE`**: MIT license terms - **[`CHANGELOG.md`](https://github.com/Leonxlnx/taste-skill/blob/main/CHANGELOG.md)**: Version history and release notes - **[`skill.sh`](https://github.com/Leonxlnx/taste-skill/blob/main/skill.sh)**: Bash wrapper for skill execution ## Summary - The **Leonxlnx/taste-skill** repository organizes code into five primary directories: `skills/`, `research/`, `examples/`, `assets/`, and `.github/` - The **`skills/`** directory contains modular skill definitions with individual [`SKILL.md`](https://github.com/Leonxlnx/taste-skill/blob/main/SKILL.md) documentation files - **`research/`** houses analytical documentation and design notes, including topics like laziness remediation - The **[`skill.sh`](https://github.com/Leonxlnx/taste-skill/blob/main/skill.sh)** script provides a command-line interface for executing any skill defined in the repository - Root-level files include standard open-source project metadata and a specialized execution helper ## Frequently Asked Questions ### What is the purpose of the skills/ directory in Leonxlnx/taste-skill? The `skills/` directory hosts individual skill implementations, with each subfolder representing a distinct capability like `taste-skill` or `stitch-skill`. Every skill contains a [`SKILL.md`](https://github.com/Leonxlnx/taste-skill/blob/main/SKILL.md) file that defines its behavior, parameters, and configuration requirements. ### How do I run a specific skill from the Leonxlnx/taste-skill repository? Use the [`skill.sh`](https://github.com/Leonxlnx/taste-skill/blob/main/skill.sh) script located in the repository root. Execute `./skill.sh run ""` where `` corresponds to a subdirectory within `skills/`. This wrapper abstracts the underlying execution environment for local testing. ### Where are research notes and analysis stored in the repository? Research documentation occupies the `research/` directory, organized into topical subdirectories. For instance, files like [`research/laziness/remediation/parameter-tuning.md`](https://github.com/Leonxlnx/taste-skill/blob/main/research/laziness/remediation/parameter-tuning.md) contain detailed analysis of specific technical challenges and their solutions. ### What file contains the main project documentation? The [`README.md`](https://github.com/Leonxlnx/taste-skill/blob/main/README.md) file in the repository root provides the primary project overview, installation instructions, and architectural guidance. Visual assets referenced by this documentation reside in the separate `assets/` directory.