Skip to content

Latest commit

 

History

History
147 lines (101 loc) · 4.64 KB

README.md

File metadata and controls

147 lines (101 loc) · 4.64 KB

Deno Development Skills

Modern Deno development knowledge for AI coding assistants. These skills teach your AI assistant how to build Deno applications using current best practices.

Skills

Skill Description
deno-guidance Core Deno best practices, JSR packages, CLI commands
deno-deploy Deployment workflows for Deno Deploy
deno-frontend Fresh framework, Preact components, Tailwind CSS
deno-sandbox Safe code execution with @deno/sandbox
deno-project-templates Project scaffolding templates
deno-expert Code review and debugging principles

Key Principles

These skills enforce modern Deno practices:

  1. JSR over deno.land/x - Always use jsr: imports; deno.land/x is deprecated
  2. npm: as fallback - Use npm: packages when no JSR alternative exists
  3. Built-in tools - Encourage deno fmt, deno lint, deno test, deno doc
  4. Fresh patterns - Island architecture with small, serializable-prop islands

Versioning

This project uses Semantic Versioning. When contributing changes:

When to Bump Versions

Change Type Version Bump Example
Breaking changes MAJOR (1.0 → 2.0) Fundamentally altering how a skill works
New features, significant updates MINOR (1.1 → 1.2) Adding new guidance, updating documentation
Typo fixes, small clarifications PATCH (1.1.0 → 1.1.1) Fixing formatting, correcting typos

Files to Update

When making changes, update the appropriate version numbers:

  1. Skill-specific changes - Update the skill's version in its SKILL.md frontmatter
  2. Plugin releases - Update version in both:
    • .claude-plugin/plugin.json
    • .claude-plugin/marketplace.json

For Contributors

  • Include version bumps in your PRs when changing skill content
  • Use conventional commits (e.g., feat:, fix:, docs:) to indicate change type
  • When in doubt, bump the MINOR version for content changes

Installation

These skills follow the Agent Skills Specification.

Claude Code

Option 1: Install as a plugin

# Step 1: Add the marketplace
/plugin marketplace add denoland/skills

# Step 2: Install the plugin
/plugin install deno-skills@denoland-skills

Option 2: Manual installation

Copy the skills you want to use:

# Clone the repository
git clone https://github.com/denoland/skills.git /tmp/deno-skills

# Copy individual skills to your personal skills directory
cp -r /tmp/deno-skills/skills/deno-guidance ~/.claude/skills/
cp -r /tmp/deno-skills/skills/deno-deploy ~/.claude/skills/
# ... or copy all skills
cp -r /tmp/deno-skills/skills/* ~/.claude/skills/

# Or for project-specific installation
cp -r /tmp/deno-skills/skills/* .claude/skills/

Cursor

Note: Agent Skills in Cursor are currently only available in v2.4+.

# Clone the repository
git clone https://github.com/denoland/skills.git /tmp/deno-skills

# Copy skills to your Cursor skills directory
cp -r /tmp/deno-skills/skills/* ~/.cursor/skills/

# Or for project-specific installation
cp -r /tmp/deno-skills/skills/* .cursor/skills/

VS Code with GitHub Copilot

Note: Agent Skills require the chat.useAgentSkills setting to be enabled (currently in preview).

# Clone the repository
git clone https://github.com/denoland/skills.git /tmp/deno-skills

# Copy skills to your project's skills directory
mkdir -p .github/skills
cp -r /tmp/deno-skills/skills/* .github/skills/

# Or for personal installation
cp -r /tmp/deno-skills/skills/* ~/.copilot/skills/

To enable Agent Skills in VS Code:

  1. Open VS Code Settings (Cmd/Ctrl + ,)
  2. Search for chat.useAgentSkills
  3. Enable the setting

Other Platforms

For other AI coding assistants that support the Agent Skills specification, copy the skill directories from skills/ to your platform's skills directory. Check your platform's documentation for the correct location.

Usage

Once installed, your AI assistant will automatically apply Deno best practices when:

  • Working in projects with a deno.json file
  • Creating new Deno applications
  • Adding dependencies
  • Deploying to Deno Deploy
  • Building Fresh web applications
  • Running user code in sandboxes

Documentation Resources

License

MIT License - see LICENSE