Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Devvit skills

Give your AI coding agent better instructions for building, maintaining, and debugging Devvit apps.

These skills are experimental and may change.

What is a skill?

A skill is a small set of instructions and scripts that teaches an AI coding agent how to handle a specific kind of task. It is not a dependency in your Devvit app, and it does not become part of your production code.

After you install a skill, you can talk to your agent as usual. The agent reads the skill's description and uses it when your request matches. For example, a documentation skill can teach the agent where to find the right Devvit docs and how to cite them.

This repository uses the vercel-labs/skills installer and follows the Agent Skills format.

Install

You need Node.js and a supported coding agent.

Open a terminal in your Devvit project, then run:

npx skills add reddit/devvit-skills

The installer will ask which skills and coding agents you want to use. If you are unsure, select devvit-docs, choose your coding agent, and use the recommended symlink installation.

If your agent does not notice the newly installed skill, start a new session and try again.

Then ask a normal Devvit question:

How do I add a custom post action to my Devvit app?

Your agent should recognize that the question matches devvit-docs and use the skill automatically.

Install only what you need

As this collection grows, you can inspect the available skills before installing anything:

npx skills add reddit/devvit-skills --list

Install one skill by name:

npx skills add reddit/devvit-skills --skill devvit-docs

The default installation applies to the current project. Add --global if you want the skill available in all of your projects:

npx skills add reddit/devvit-skills --skill devvit-docs --global

Do I need to edit AGENTS.md?

No. Each skill already tells your agent when to use it.

If your team wants an extra reminder in its agent instructions, you can add this optional, skill-independent rule:

Use installed Devvit skills when their descriptions match the task.

This rule applies only to the Devvit skills a developer chooses to install, including skills added to this repository in the future.

Available skills

devvit-docs

Recommended for Devvit development. This skill searches the official reddit/devvit-docs repository and cites the files and sections used in its answer. It also looks for the Devvit version in your project so it can prefer matching documentation.

Use it for questions such as:

How do I configure devvit.json?
Show me an example of a menu action.
What triggers are available in Devvit?
Where is the form API documented?

The first lookup downloads a local, text-only copy of the docs. Later lookups reuse that cache and refresh it when needed. The skill requires Git and network access for the initial download.

Manage installed skills

The skills CLI can show, update, and remove installed skills:

npx skills list
npx skills update devvit-docs
npx skills remove devvit-docs

See the vercel-labs/skills README for agent-specific installation options and the full CLI reference.

About

A collection of helpful skills for working with devvit

Resources

Code of conduct

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages