agentinit 1.8.1 → 1.10.0

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [1.10.0](https://github.com/agentinit/agentinit/compare/v1.9.0...v1.10.0) (2026-03-29)
+
+
+### Features
+
+* **marketplace:** default bare plugin installs to agentinit ([71a888f](https://github.com/agentinit/agentinit/commit/71a888f67950a465445c16bb32b2a5a387a46cbe))
+
+# [1.9.0](https://github.com/agentinit/agentinit/compare/v1.8.1...v1.9.0) (2026-03-29)
+
+
+### Features
+
+* canonicalize shared skills and rules aliases ([9a3b47b](https://github.com/agentinit/agentinit/commit/9a3b47b242578ba022f2e7266be92d2efa47674b))
+
 ## [1.8.1](https://github.com/agentinit/agentinit/compare/v1.8.0...v1.8.1) (2026-03-29)
 
 
@@ -29,6 +43,7 @@
 ### Bug Fixes
 
 * fix plugin scope handling for global MCP installs/removals and targeted removals
+* preserve revert semantics for canonical project skills and keep `skills remove` project-scoped by default
 * update docs and onboarding to the `mcp add|verify`, `rules add`, and `skills add` command model
 
 # [1.7.0](https://github.com/agentinit/agentinit/compare/v1.6.0...v1.7.0) (2025-10-17)

package/README.md

@@ -96,6 +96,7 @@ agentinit apply                        # Sync + project skills + managed ignore
 agentinit apply --agent claude cursor  # Target specific agents
 agentinit apply --dry-run              # Preview changes
 agentinit apply --backup               # Create sibling .agentinit.backup files
+agentinit apply --copy-skills          # Copy project skills instead of using canonical symlink installs
 agentinit apply --no-skills            # Skip project-owned skills
 agentinit apply --gitignore-local      # Write ignore entries to .git/info/exclude
 ```
@@ -163,24 +164,40 @@ agentinit rules add --global --agent claude --template git,write_tests
 
 ### `agentinit skills`
 
-Install, list, and remove reusable agent skills from local paths or GitHub repositories.
+Install, list, and remove reusable agent skills from marketplaces, local paths, or GitHub repositories.
 
 **Examples:**
 ```bash
 # Inspect a source before installing
 agentinit skills add owner/repo --list
 
-# Install all discovered skills for detected agents
+# Install a public skill from the default catalog (`vercel-labs/agent-skills`)
+agentinit skills add vercel-react-best-practices
+
+# Install all discovered skills for detected agents using canonical storage
 agentinit skills add ./skills
 
+# Install marketplace-hosted skills explicitly
+agentinit skills add claude/skill-creator
+agentinit skills add skill-creator --from claude
+
 # Install selected skills globally for a specific agent
 agentinit skills add owner/repo --global --agent claude --skill openai-docs
 
+# Force copied installs instead of canonical symlink installs
+agentinit skills add ./skills --copy
+
 # Review and clean up installed skills
 agentinit skills list
 agentinit skills remove openai-docs
 ```
 
+Skills are installed into a canonical store by default: project installs use `.agents/skills/`, and global installs use `~/.agents/skills/`. Agent-specific paths are symlinked to that store when they differ. Use `--copy` or `--copy-skills` to force independent copies instead.
+
+Bare skill names default to the public skills catalog used by the open agent skills ecosystem: `vercel-labs/agent-skills`. Use `./name` for a local path, `owner/repo` for an explicit GitHub repository, or `--from <marketplace>` / `<marketplace>/<name>` for marketplace-backed sources.
+
+Marketplace-backed `skills add` installs only the discovered skills. If a marketplace source also contains MCP servers or other portable components, AgentInit warns and points you to `agentinit plugins install ...` for the full install.
+
 ### `agentinit plugins`
 
 Install, inspect, search, and remove portable plugins from explicit marketplace sources, GitHub repositories, or local paths.
@@ -198,6 +215,7 @@ agentinit plugins install code-review --from claude
 # Install from GitHub or a local path
 agentinit plugins install owner/repo
 agentinit plugins install ./plugins/code-review
+agentinit plugins install ./plugins/code-review --copy-skills
 
 # Inspect and remove installed plugins
 agentinit plugins list
@@ -235,6 +253,8 @@ your-project/
 ├── CLAUDE.md                 # Claude-specific config (synced)
 ├── .cursorrules              # Cursor-specific config (synced)
 ├── AGENTS.md                 # Shared AGENTS.md standard for supporting agents
+├── .agents/skills/           # Canonical project skill storage
+├── .claude/skills/           # Claude skill view (often symlinks into .agents/skills)
 ├── .windsurfrules            # Windsurf-specific config (synced)
 └── .agentinit/               # Managed state and internal backups
 ```
@@ -246,6 +266,9 @@ your-project/
 The `agents.md` file is the single source of truth for all agent configurations:
 
 ```markdown
+---
+rules_alias: agents # optional: make AGENTS.md canonical and symlink CLAUDE.md to it
+---
 # Agent Configuration for MyProject
 
 **Stack**: typescript with next.js
@@ -275,6 +298,8 @@ This is a TypeScript project using Next.js...
 
 `AGENTS.md` is a shared standard used by multiple tools, so AgentInit does not use it by itself as an auto-detection signal.
 
+When `rules_alias: agents` is set in `agents.md` frontmatter, AgentInit writes shared rules to `AGENTS.md` and makes `CLAUDE.md` a symlinked alias when Claude is targeted. If symlink creation fails, AgentInit falls back to writing a copied `CLAUDE.md`.
+
 | Agent | Config File | Status |
 |-------|-------------|--------|
 | Claude | `CLAUDE.md` | ✅ |