---
title: Guides
description: PromptScript guides and best practices
---

# Guides

Learn best practices and patterns for using PromptScript effectively.

<div class="ref-list">

<a href="registry/" class="ref-item">
  <div class="ref-item__icon ref-item__icon--purple">
    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path fill="currentColor" d="M12 3L2 12h3v8h6v-6h2v6h6v-8h3L12 3m5 15h-2v-6H9v6H7v-7.81l5-4.5l5 4.5V18Z"/></svg>
  </div>
  <div class="ref-item__content">
    <h3>Registry</h3>
    <p>Create, manage, and share PromptScript registries for your organization.</p>
  </div>
  <div class="ref-item__arrow">→</div>
</a>

<a href="inheritance/" class="ref-item">
  <div class="ref-item__icon ref-item__icon--blue">
    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path fill="currentColor" d="M12 2a3 3 0 0 1 3 3c0 1.4-.95 2.57-2.25 2.9V10h2.75a2.5 2.5 0 0 1 2.5 2.5v1.59c1.29.34 2.25 1.5 2.25 2.91a3 3 0 0 1-3 3a3 3 0 0 1-3-3c0-1.4.95-2.57 2.25-2.9V12.5a.5.5 0 0 0-.5-.5h-6.5a.5.5 0 0 0-.5.5v1.59c1.3.33 2.25 1.5 2.25 2.91a3 3 0 0 1-3 3a3 3 0 0 1-3-3c0-1.4.95-2.57 2.25-2.9V12.5A2.5 2.5 0 0 1 8.5 10h2.75V7.9A3 3 0 0 1 9 5a3 3 0 0 1 3-3z"/></svg>
  </div>
  <div class="ref-item__content">
    <h3>Inheritance</h3>
    <p>Build scalable instruction hierarchies with inheritance patterns.</p>
  </div>
  <div class="ref-item__arrow">→</div>
</a>

<a href="multi-file/" class="ref-item">
  <div class="ref-item__icon ref-item__icon--cyan">
    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path fill="currentColor" d="M15 4H5v16h14V8h-4V4M5 2h12l4 4v14a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2m4 14h8v2H9v-2m0-4h8v2H9v-2m0-4h4v2H9V8z"/></svg>
  </div>
  <div class="ref-item__content">
    <h3>Multi-File Organization</h3>
    <p>Organize your PromptScript files for complex projects with imports and fragments.</p>
  </div>
  <div class="ref-item__arrow">→</div>
</a>

<a href="npx-skills/" class="ref-item">
  <div class="ref-item__icon ref-item__icon--teal">
    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path fill="currentColor" d="M8 16h8v2H8zm0-4h8v2H8zm6-10H6c-1.1 0-2 .9-2 2v16c0 1.1.89 2 1.99 2H18c1.1 0 2-.9 2-2V8l-6-6zm4 18H6V4h7v5h5v11z"/></svg>
  </div>
  <div class="ref-item__content">
    <h3>Using npx skills</h3>
    <p>Install open-source skills from GitHub repositories with <code>npx skills</code> and compile them to all your AI agents.</p>
  </div>
  <div class="ref-item__arrow">→</div>
</a>

<a href="building-skills/" class="ref-item">
  <div class="ref-item__icon ref-item__icon--purple">
    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path fill="currentColor" d="M22.7 19l-9.1-9.1c.9-2.3.4-5-1.5-6.9-2-2-5-2.4-7.4-1.3L9 6 6 9 1.6 4.7C.4 7.1.9 10.1 2.9 12.1c1.9 1.9 4.6 2.4 6.9 1.5l9.1 9.1c.4.4 1 .4 1.4 0l2.3-2.3c.5-.4.5-1.1.1-1.4z"/></svg>
  </div>
  <div class="ref-item__content">
    <h3>Building Skills</h3>
    <p>Create custom skills from scratch - SKILL.md format, parameters, resource files, contracts, and publishing.</p>
  </div>
  <div class="ref-item__arrow">→</div>
</a>

<a href="local-skills/" class="ref-item">
  <div class="ref-item__icon ref-item__icon--cyan">
    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path fill="currentColor" d="M20 6h-8l-2-2H4c-1.1 0-2 .9-2 2v12c0 1.1.9 2 2 2h16c1.1 0 2-.9 2-2V8c0-1.1-.9-2-2-2m-6 10H6v-2h8v2m4-4H6v-2h12v2Z"/></svg>
  </div>
  <div class="ref-item__content">
    <h3>Local Skills</h3>
    <p>Full reference for local skills - resolution order, resource files, parameterized skills, and dependencies.</p>
  </div>
  <div class="ref-item__arrow">→</div>
</a>

<a href="ci/" class="ref-item">
  <div class="ref-item__icon ref-item__icon--green">
    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path fill="currentColor" d="M12 20a8 8 0 0 1-8-8a8 8 0 0 1 8-8a8 8 0 0 1 8 8a8 8 0 0 1-8 8m0-18A10 10 0 0 0 2 12a10 10 0 0 0 10 10a10 10 0 0 0 10-10A10 10 0 0 0 12 2m-1 5v6l5.25 3.15l.75-1.23l-4.5-2.67V7z"/></svg>
  </div>
  <div class="ref-item__content">
    <h3>CI/CD Integration</h3>
    <p>Validate and test PromptScript files in your CI pipeline with GitHub Actions.</p>
  </div>
  <div class="ref-item__arrow">→</div>
</a>

<a href="enterprise/" class="ref-item">
  <div class="ref-item__icon ref-item__icon--amber">
    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path fill="currentColor" d="M18 15h-2v2h2m0-6h-2v2h2m2 6h-8v-2h2v-2h-2v-2h2v-2h-2V9h8M10 7H8V5h2m0 6H8V9h2m0 6H8v-2h2m0 6H8v-2h2M6 7H4V5h2m0 6H4V9h2m0 6H4v-2h2m0 6H4v-2h2m6-10V3H2v18h20V7z"/></svg>
  </div>
  <div class="ref-item__content">
    <h3>Enterprise Setup</h3>
    <p>Deploy PromptScript across your organization with private registries and governance.</p>
  </div>
  <div class="ref-item__arrow">→</div>
</a>

<a href="migration/" class="ref-item">
  <div class="ref-item__icon ref-item__icon--orange">
    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path fill="currentColor" d="M6.99 11L3 15l3.99 4v-3H14v-2H6.99zM21 9l-3.99-4v3H10v2h7.01v3z"/></svg>
  </div>
  <div class="ref-item__content">
    <h3>Migration</h3>
    <p>Migrate existing AI instructions from CLAUDE.md, .cursorrules, and other formats.</p>
  </div>
  <div class="ref-item__arrow">→</div>
</a>

<a href="security/" class="ref-item">
  <div class="ref-item__icon ref-item__icon--red">
    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path fill="currentColor" d="M12 1L3 5v6c0 5.55 3.84 10.74 9 12c5.16-1.26 9-6.45 9-12V5l-9-4m0 10.99h7c-.53 4.12-3.28 7.79-7 8.94V12H5V6.3l7-3.11v8.8z"/></svg>
  </div>
  <div class="ref-item__content">
    <h3>Security</h3>
    <p>Security considerations for templates, external stacks, and best practices.</p>
  </div>
  <div class="ref-item__arrow">→</div>
</a>

</div>
