# What Is Included in the Reference Files for claude-skills?

> Discover what's inside claude-skills reference files. Explore detailed Markdown docs with tutorials, code samples, config templates, and architectural patterns to master skills.

- Repository: [Jeffallan/claude-skills](https://github.com/jeffallan/claude-skills)
- Tags: getting-started
- Published: 2026-02-16

---

**The reference files for claude-skills are comprehensive Markdown guides stored under `skills/*/references/` that expand concise skill definitions into detailed technical documentation containing domain-specific tutorials, production-ready code samples, configuration templates, and architectural patterns.**

The *claude-skills* repository by Jeffallan provides a structured framework for AI-assisted development workflows. At its core, the **reference files for claude-skills** serve as the deep-knowledge backbone, transforming concise [`SKILL.md`](https://github.com/Jeffallan/claude-skills/blob/main/SKILL.md) descriptors into self-contained technical guides that typically range from 100 to 600 lines of detailed documentation.

## Core Content Types in claude-skills Reference Files

### Domain-Specific Tutorials and Theory

These files provide step-by-step explanations of technologies or patterns, including background theory and "when-to-use" guidance. For example, the WordPress theme development reference covers template hierarchy and block theme architecture in [`skills/wordpress-pro/references/theme-development.md`](https://github.com/Jeffallan/claude-skills/blob/main/skills/wordpress-pro/references/theme-development.md).

### Production-Ready Code Samples

Reference files contain ready-to-paste snippets in the skill's native language—whether PHP, TypeScript, Ruby, or SQL. The React Native storage reference provides complete hook implementations for AsyncStorage and MMKV integration in [`skills/react-native-expert/references/storage-hooks.md`](https://github.com/Jeffallan/claude-skills/blob/main/skills/react-native-expert/references/storage-hooks.md).

### Configuration Templates and Architecture Patterns

Full configuration files appear with inline comments describing each option. You'll find complete [`theme.json`](https://github.com/Jeffallan/claude-skills/blob/main/theme.json) specifications for WordPress block themes and database configuration examples for Rails applications in their respective reference directories.

### Performance Optimization and Security Guidance

Dedicated sections cover indexing strategies, query planning, partitioning, and security best practices. The Postgres performance reference includes `EXPLAIN ANALYZE` examples and JSONB optimization patterns in [`skills/postgres-pro/references/performance.md`](https://github.com/Jeffallan/claude-skills/blob/main/skills/postgres-pro/references/performance.md).

## Repository Structure and Progressive Disclosure

The reference files follow a strict organizational pattern under `skills/*/references/`. Each skill directory contains a concise [`SKILL.md`](https://github.com/Jeffallan/claude-skills/blob/main/SKILL.md) (approximately 80 lines) that provides high-level workflow guidance, while the companion reference files deliver the heavy-lifting technical details.

This architecture implements the **progressive disclosure** principle defined in [`CLAUDE.md`](https://github.com/Jeffallan/claude-skills/blob/main/CLAUDE.md): agents first consult the compact skill definition for context, then dive into reference files for implementation specifics without bloating the main skill descriptor.

## Practical Examples from the Source Code

### React Native Storage Hooks

The [`storage-hooks.md`](https://github.com/Jeffallan/claude-skills/blob/main/storage-hooks.md) file in `skills/react-native-expert/references/` provides complete implementations for persistent storage:

```typescript
import { useStorage } from './useStorage'; // defined in storage-hooks.md

function ThemeToggle() {
  const { value: theme, setValue: setTheme, loading } = useStorage('theme', 'light');

  if (loading) return <ActivityIndicator />;

  return (
    <Switch
      value={theme === 'dark'}
      onValueChange={isDark => setTheme(isDark ? 'dark' : 'light')}
    />
  );
}

```

### WordPress Block Pattern Registration

From [`skills/wordpress-pro/references/theme-development.md`](https://github.com/Jeffallan/claude-skills/blob/main/skills/wordpress-pro/references/theme-development.md), this snippet demonstrates block pattern registration:

```php
<?php
/**
 * patterns/hero-section.php
 *
 * Title: Hero Section
 * Slug: theme-name/hero-section
 */
declare(strict_types=1);
defined('ABSPATH') || exit;
?>
<!-- wp:cover {"url":"<?php echo esc_url(get_template_directory_uri()); ?>/assets/images/hero-bg.jpg","dimRatio":60,"align":"full"} -->
<div class="wp-block-cover alignfull">
    <!-- Content … -->
</div>
<!-- /wp:cover -->

```

### Postgres JSONB Queries

The [`jsonb.md`](https://github.com/Jeffallan/claude-skills/blob/main/jsonb.md) reference in `skills/postgres-pro/references/` includes optimized JSONB querying patterns:

```sql
SELECT id, data->>'type' AS type
FROM events
WHERE data @> '{"status":"completed"}';

```

## Summary

- **Reference files for claude-skills** are comprehensive Markdown guides stored under `skills/*/references/` that expand concise skill definitions into detailed technical documentation.
- Each file typically contains 100-600 lines of domain-specific tutorials, production-ready code samples, configuration templates, and architectural patterns.
- The repository implements **progressive disclosure**: short [`SKILL.md`](https://github.com/Jeffallan/claude-skills/blob/main/SKILL.md) files provide high-level context while reference files deliver implementation details.
- Content covers performance optimization, security best practices, migration guides, and tool-specific cheat-sheets across multiple technology stacks including React Native, WordPress, Rails, and Postgres.

## Frequently Asked Questions

### Where are the reference files located in the claude-skills repository?

Reference files are stored in the `skills/*/references/` directory pattern, where each skill folder contains a `references/` subdirectory housing one or more Markdown files (e.g., [`theme-development.md`](https://github.com/Jeffallan/claude-skills/blob/main/theme-development.md), [`storage-hooks.md`](https://github.com/Jeffallan/claude-skills/blob/main/storage-hooks.md)).

### How do reference files differ from SKILL.md files?

[`SKILL.md`](https://github.com/Jeffallan/claude-skills/blob/main/SKILL.md) files provide high-level workflow guidance in approximately 80 lines, while reference files expand these concepts into comprehensive technical guides ranging from 100-600 lines, containing detailed code samples, configurations, and architectural patterns.

### What programming languages and frameworks are covered in the reference files?

The repository includes reference files for multiple technology stacks including **React Native** (TypeScript hooks), **WordPress** (PHP block themes), **Ruby on Rails** (API development), **PostgreSQL** (JSONB and performance), **Next.js** (server components), **MCP SDK** (TypeScript), and **Embedded Systems** (RTOS patterns).

### Can I contribute new reference files to the claude-skills repository?

While the analysis focuses on existing content structure, reference files follow the established `skills/*/references/*.md` pattern and implement the progressive disclosure principle defined in [`CLAUDE.md`](https://github.com/Jeffallan/claude-skills/blob/main/CLAUDE.md). Contributors should ensure files contain self-contained technical guides with runnable code samples and configuration templates consistent with existing reference quality.