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

• Deno Documentation
• Fresh Framework
• JSR Package Registry
• Deno Deploy
• Agent Skills Specification

License

MIT License - see LICENSE