Replit Agent Customization: Custom Instructions and Skills

What Is Agent Customization?

Replit introduced Agent Customization, a workspace-level configuration system that allows teams and individual developers to encode their standards, workflows, and constraints directly into the Agent — so those rules apply consistently across every project and every session without requiring manual re-entry.

Agent Customization has two distinct components: Custom Instructions and Skills. Each serves a different purpose and operates differently within the Agent's decision-making process.

Custom Instructions: Always-On Workspace Guidelines

Custom Instructions are persistent, workspace-wide directives that the Agent follows throughout every conversation and every task. Think of them as standing orders: security policies, preferred frameworks, naming conventions, or data-handling requirements that the Agent should always respect — regardless of what the user is asking it to build.

Because Custom Instructions are always active, they are best suited for non-negotiable rules. Examples include enforcing that all database queries go through a specific ORM, requiring that environment variables never be hardcoded, or mandating the use of a particular authentication library. Once set, users no longer need to repeat these constraints at the start of every conversation.

Custom Instructions are available on Pro and Enterprise plans.

Skills: Selective, Task-Specific Instruction Sets

Skills are reusable Markdown instruction sets that load into the Agent's context only when they are relevant to the task at hand. Unlike Custom Instructions, which are always present, Skills are selective — the Agent determines which Skills apply based on what is being built or discussed.

This selective loading keeps the Agent's context focused and efficient. A Skill for Stripe integration, for example, would only activate when the user is working on payment flows, not when they are building an unrelated UI component.

Skills can be created in three ways:

• Written directly in the Skills editor in workspace settings
• Imported from a URL — any public Markdown file can become a Skill
• Selected from the Skills Directory — a curated library of partner-built Skills

Skills are available on all paid tiers (Core, Pro, and Enterprise).

Skills Directory: Partner-Built Skills at Launch

Replit launched a Skills Directory with pre-built Skills contributed by integration partners. At launch, the directory includes Skills from:

• Atlassian (Jira, Confluence workflows)
• Mixpanel (analytics event tracking patterns)
• Google (Cloud and Workspace integrations)
• PayPal (payment integration best practices)
• Resend (transactional email setup)
• RevenueCat (subscription and monetization flows)
• Stripe (payments and billing)

These partner Skills encode the providers' own recommended patterns, so the Agent builds integrations the way the provider intends — reducing misconfiguration and the need for developers to cross-reference documentation manually.

Why It Matters

Agent Customization addresses a persistent pain point in AI-assisted development: context loss. Without persistent instructions, developers must re-explain their constraints and preferences at the start of every new session. For teams, this problem compounds — different team members prompt the Agent differently, leading to inconsistent outputs.

By giving teams a structured way to encode their standards once, Replit shifts the Agent from a general-purpose tool into a tool that understands the specific environment it is operating in. For organizations with strict security or compliance requirements, Custom Instructions provide a reliable enforcement layer. For developers building on third-party APIs, Skills provide a shortcut to integration best practices without requiring them to internalize every provider's documentation.