Skip to content

hardis:project:skills:import

Description

Command Behavior

Imports Claude Code skills, agents, and rules from a remote git repository into the current project.

This command streamlines the process of sharing and reusing AI coding agent configurations across projects. It clones a remote repository containing .claude/ configuration files (skills, agents, rules) into a temporary directory, then copies them into the current project's .claude/ folder.

Key functionalities:

  • Remote Repository Cloning: Clones the specified git repository into a temporary directory for file extraction.
  • File Copy with Overwrite Control: Copies .claude/skills/, .claude/agents/, .claude/rules/, CLAUDE.md, and WORKFLOW.md from the cloned repo into the current project. If any files already exist, prompts once to overwrite all or skip all (defaults to overwrite).
  • Config Persistence: When --repo is not provided, reads the repo URL from the skillsRepo config property. If not found, prompts the user and stores the URL for future use.
  • Add-On Mode: When --addon is used, the resolved repository URL is appended to the skillsRepoAddOns array config property instead of being saved as the main skillsRepo. This lets you track a main skills repo plus a list of complementary add-on repos in the project config. The actual files are still imported from a single repo per invocation; merging across the main repo and add-ons is expected to be handled separately by an agent later.
  • Agent Mode: Supports --agent flag for non-interactive CI/CD and automation use. In agent mode, --repo or skillsRepo config must be set, and existing files are always overwritten.
Technical explanations
  • Clones the repo with git clone --depth 1 (shallow clone for speed) into a temp directory created via createTempDir().
  • Walks the .claude/ subdirectories (skills, agents, rules) in the cloned repo and copies each file into the corresponding path in the current project.
  • In interactive mode, if any existing files are detected, a single overwrite prompt is shown (default: overwrite all).
  • In agent mode (--agent), all existing files are silently overwritten.
  • With --addon, the URL is appended (deduplicated) to the skillsRepoAddOns string array config property; without it, the URL replaces the skillsRepo string config property as before.
  • The temporary directory is cleaned up after the operation completes.

Parameters

Name Type Description Default Required Options
addon boolean Persist the repository URL to the skillsRepoAddOns array config property instead of the main skillsRepo property
agent boolean Run in non-interactive mode for agents and automation
debug
-d		 boolean Activate debug mode (more logs)
flags-dir option undefined
json boolean Format output as json.
repo
-r		 option Git repository URL containing .claude/ skills, agents, and rules to import
skipauth boolean Skip authentication check when a default username is required
websocket option Websocket host:port for VsCode SFDX Hardis UI integration

Examples

$ sf hardis:project:skills:import

$ sf hardis:project:skills:import --repo https://github.com/mycompany/claude-skills.git

$ sf hardis:project:skills:import --repo https://github.com/mycompany/claude-skills-billing.git --addon

$ sf hardis:project:skills:import --agent --repo https://github.com/mycompany/claude-skills.git