• Documentation
  • Pricing
© 2026 Serverless, Inc. All rights reserved.

Framework

  • Overview
  • Documentation
  • Plugins360
  • Pricing

Learn

  • Blog
  • GuidesUpdated
  • Examples240
  • Courses

Resources

  • Support
  • Security
  • Trust Center
  • Status

Community

  • Slack
  • GitHub47k
  • Forum
  • Meetups

Company

  • About
  • Careers
  • Contact
  • Partners

Legal

  • Terms of Service
  • Privacy Policy
  • Trademark
  • DMCA
Serverless Framework Logo

Serverless Framework

Intro
SetupUpgrading To V4ConceptsTutorialAWS CredentialsLicense Keys
DeployingPackagingBuildingTestingDev ModeServicesFunctions
OverviewHTTP (API Gateway v2)REST (API Gateway v1)ActiveMQApplication Load BalancerAlexa SkillAlexa Smart HomeCloudWatch EventCloudWatch LogCloudFrontCognito User PoolEventBridge EventIoTIoT Fleet ProvisioningKafkaKinesis & DynamoDBMSKRabbitMQS3ScheduleSNSSQSWebsocket
LayersManaged InstancesWeb Apps (Lambda Web Functions)Sandboxes (Lambda MicroVMs)MCP ServersAlertsVersion PruningDomainsIAM Function PermissionsParameters
OverviewSelf-reference serverless.ymlServerless CoreEnvironment VariablesCLI OptionsExternal YAML/JSON FilesJavascript propertiesGitDoppler
OverviewS3 ObjectsSSM Parameter Store & Secrets ManagerCloudFormation Stack Outputs
OverviewVaultTerraform State Output
ResourcesComposing ServicesDeployment BucketStateAgent SkillsPython support
OverviewRuntimeGatewayMemoryBrowserCode InterpreterDev Mode
API Gateway Proxy
OverviewGeneral ConfigurationAuthenticationAPI KeysData SourcesResolversPipeline FunctionsSubstitutionsCachingDelta SyncCustom DomainWAFCLI Commands
Deploying SAM/CFN TemplatesWorkflow Tips
OverviewCreating PluginsCLI OutputCustom CommandsCustom VariablesExtending the Configuration schemaExtending and overriding configuration
OverviewDashboardAxiom
Overviewagent docsagent inspectagent setupagent skills installagent skills list / readdeploydeploy functiondeploy listdevdiffinfoinvokeinvoke localloginlogin awslogin aws ssologsmetricspackageplugin installplugin uninstallprintprunereconcileremoverollbackrollback functionusage
OverviewConcepts
OverviewMetricsTracesTroubleshoot
OverviewNode.jsPython
OutputsProviders
OverviewBranch DeploymentsPreview DeploymentsCustom ScriptsTestingPrivate PackagesNotificationsMono ReposDeploy in your own CI/CDBest PracticesTroubleshootingFAQ
OverviewSetupToolsAWS Integration
Serverless.yml Reference
Examples and TutorialsConfiguration Validation
  1. CLI Reference
  2. Agent Skills Install

serverless agent skills install

serverless agent skills install writes the Agent Skills bundled with the Serverless Framework CLI to disk: the project skills into the service directory, and the user-level serverless-framework skill into your home directory. Skills are instruction files that AI coding agents (Claude Code, Codex, Cursor and other agents that read the open Agent Skills format) load when a task involves their feature. Use it to install or refresh skills only; serverless agent setup installs the same skills and also reports whether sign-in and AWS credentials are ready.

serverless agent skills install

Run it in the service directory, where serverless.yml is. Anywhere else, serverless agent skills install installs only the user-level skill.

Options

serverless agent skills install accepts this option:

OptionAliasValueDefaultRequiredDescription
--dirclaude or agents; repeatable or comma-separateddetectedNoWrite only to these skill directories, for the project skills and the user-level skill: claude is .claude/skills/, agents is .agents/skills/.

Any other --dir value exits 1 with Unknown --dir value "<value>". Valid values: claude, agents. serverless agent skills install also accepts --config (-c), --debug and --help (-h).

Files serverless agent skills install writes

Each skill is a folder named after the skill, with its SKILL.md and reference files, inside a skills directory:

  • Project skills go into .claude/skills/ and .agents/skills/ in the service directory (at a Compose root, beside serverless-compose.yml). Without --dir, the first rule that matches picks the directories:
    1. the skills directories that already hold Framework-managed skills;
    2. else, the service's .claude/ and .agents/ directories that exist;
    3. else, the agents found in your home directory: ~/.claude selects .claude/skills/; ~/.agents, ~/.codex or ~/.cursor select .agents/skills/;
    4. else, both.
  • The user-level serverless-framework skill goes into ~/.claude/skills/ and ~/.agents/skills/: with --dir, the directories it names; without it, those of the agents found in your home directory (the markers in rule 3), or both when none is found. When the environment has no home directory, the user-level install is skipped and the output says so.

Commit the project skills so teammates' agents get them. serverless deploy and serverless package leave .claude/skills/serverless-* and .agents/skills/serverless-* out of the function package.

Re-running and customized skills

serverless agent skills install is safe to re-run. For each skill and directory, it:

  • installs the skill when its folder is missing;
  • updates the skill when the bundled version is newer than the installed metadata.version;
  • leaves the skill as it is when it is up to date;
  • skips the skill when its SKILL.md has no metadata.managed-by: serverless-framework line, which marks a skill you customized.

It never deletes files and never installs an older version. Newer CLI versions also update the managed skills they find on their own; see Automatic updates. To uninstall, delete the skill folders.

Output of serverless agent skills install

serverless agent skills install writes its report to standard error: each project directory, then one line per skill it added (+) or updated (↑), and one per customized skill it skipped. User-level lines name the directory with user:. A first run in a service:

Target: .claude/skills
  + serverless-dev-mode v2 (.claude/skills)
  + serverless-mcp v4 (.claude/skills)
  + serverless-sandboxes v6 (.claude/skills)
  + serverless-upgrade v1 (.claude/skills)
  + serverless-framework v5 (user: ~/.claude/skills)
Skills auto-update when you use a newer CLI. To customize a skill, remove its metadata.managed-by line. To uninstall, delete the skill folders.

Outside a service directory, the report adds project skills: no serverless.yml in this directory; run this command in a service directory to install them there. A CLI version that bundles no skills prints No skills are bundled with this CLI version. and writes nothing.

Non-interactive use

serverless agent skills install never prompts and needs no sign-in, so it runs the same in CI and under an AI agent. It exits 0 when it finishes. It exits 1 for an invalid --dir value, and before it runs when the service's configuration file can't be loaded, for example a serverless.yml that doesn't parse (CONFIGURATION_PARSE_ERROR).

Examples

Install into the detected agent directories

serverless agent skills install

Install only for Claude Code

serverless agent skills install --dir claude

Install into both skill directories

serverless agent skills install --dir claude,agents

Related commands

  • serverless agent setup: install the skills and report the environment status.
  • serverless agent skills list and read: see a bundled skill without installing it.
  • Agent Skills: how agents load the skills, and how to customize one.
Edit this page
Prev agent setupNextagent skills list / read

Contents

  • serverless agent skills install
  • Options
  • Files serverless agent skills install writes
  • Re-running and customized skills
  • Output of serverless agent skills install
  • Non-interactive use
  • Examples
  • Install into the detected agent directories
  • Install only for Claude Code
  • Install into both skill directories
  • Related commands

Related

GuidesPluginsExamplesSlack CommunitySupport