Agent-Skills.md

Agent Skills: Agentic Asset Share

Shared core logic for importing/exporting reusable assets into the v0.2 plugin architecture. Internal helper for agentic-import and agentic-export.

UncategorizedID: MatiasComercio/agentic-config/ac-tools-agentic-share

Repository

MatiasComercio/agentic-config
WaterplanAILicense: MIT
316

Install this agent skill to your local

pnpm dlx add-skill https://github.com/WaterplanAI/agentic-config/tree/HEAD/packages/pi-ac-tools/skills/ac-tools-agentic-share

Skill Files

Browse the full folder contents for ac-tools-agentic-share.

Download Skill

Loading file tree…

packages/pi-ac-tools/skills/ac-tools-agentic-share/SKILL.md

Skill Metadata

Name
ac-tools-agentic-share
Description
"Shared core logic for importing/exporting reusable assets into the v0.2 plugin architecture. Internal helper for agentic-import and agentic-export."

Agentic Asset Share

Compatibility Note

This pi wrapper preserves the shared import/export workflow directly in pi without relying on non-pi delegation primitives.

Core logic for moving reusable assets between projects and this repository.

Arguments

  • mode: import | export
  • asset_type: skill | template | agent
  • source: source path or asset name
  • target: optional destination name/path
  • options: optional flags (--plugin, --force, --dry-run)

Parsed from: $ARGUMENTS

Canonical Locations (v0.2)

| Type | Project Source | Repository Target | |------|----------------|-------------------| | skill | .claude/skills/<name>/ or explicit skill dir | packages/pi-<plugin>/skills/<name>/ | | template | templates/<name>/ | templates/<name>/ | | agent | explicit agent markdown path | packages/pi-ac-workflow/assets/agents/<name>/ or another explicit packaged asset path |

Notes:

  • There is no command asset type in v0.2 (skills-only surface).
  • For skills, --plugin is required unless destination can be inferred.

Execution Flow

  1. Parse mode, type, source, target, options.
  2. Validate mode (import or export).
  3. Validate asset type (skill, template, agent).
  4. Validate repository root:
    • must contain .claude-plugin/marketplace.json
    • must contain packages/
  5. Resolve source and destination paths by type.
  6. Read source content (single file or directory tree).
  7. Apply sanitization:
    • scrub absolute home paths (/Users/..., /home/...) -> {USER_HOME}
    • scrub secrets/tokens (api_key, token, secret, bearer values) -> {REDACTED}
  8. Validate sanitized output:
    • block if unresolved secrets remain
    • warn on environment-specific hardcoded values
  9. Write output (or preview with --dry-run).
  10. Report summary and next steps.

Safety Rules

  • Never overwrite existing targets without --force or explicit confirmation.
  • Never proceed when unresolved secrets remain after sanitization.
  • On any failure, abort with a clear error and leave no partial file writes.

Commit Guidance (Optional)

After successful import/export, offer a commit for only touched asset paths.

Conventional message pattern:

feat(assets): import <asset_type> '<asset_name>'

(or export accordingly)

Error Cases

| Error | Action | |-------|--------| | Invalid mode/type | Abort with valid choices | | Repository root not detected | Abort and request running from repo root | | Source missing | Abort and print source path | | Sanitization blockers remain | Abort and print blocker lines | | Target exists without force | Ask for overwrite confirmation |