@getmagical/cli 0.2.3 → 0.2.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -21,6 +21,42 @@ mgcl automation-runs list --automation-id ...
21
21
  mgcl automations run-draft --draft-automation-id ... --agent-id ... --idempotency-key ... --config-json '{"startInTakeOverMode":true,"captureActions":true,"approvalMode":"HUMAN_APPROVAL","consistencyCheckCount":3}'
22
22
  ```
23
23
 
24
+ ## Edit a Skill
25
+
26
+ The Skills working-copy commands currently support root-level skills at
27
+ `skills/<skill-name>`:
28
+
29
+ ```bash
30
+ mgcl skills pull review
31
+ # Edit ./skills/review in your editor.
32
+ mgcl skills diff review
33
+ mgcl skills push review --message "Improve review guidance"
34
+ ```
35
+
36
+ `pull` downloads the complete skill directory from the repository's default
37
+ branch and remembers the pulled contents. Tags, commit SHAs, and non-default
38
+ branches remain available through the low-level read/history commands, but are
39
+ not supported by the writable working-copy workflow.
40
+ It refuses to overwrite existing files or local edits unless you pass `--force`.
41
+ `diff` compares your files with the pulled contents. `push` sends all
42
+ additions, edits, and deletions as one commit against the current repository
43
+ head. After a successful push, the working copy and its remembered baseline
44
+ are replaced with the committed bundle read back at the new commit, so they
45
+ include any concurrent change to another file in the same skill. If that
46
+ refresh fails, the push still succeeded; re-run
47
+ `mgcl skills pull <skill> --force` to sync.
48
+
49
+ These commands do not protect concurrent edits to the same skill. If the skill
50
+ changed remotely and your local patch no longer applies, `push` fails and asks
51
+ you to pull the latest version and reapply your changes. Binary file changes
52
+ cannot be pushed.
53
+
54
+ These commands use temporary Git repositories only; they do not initialize or
55
+ modify Git state in the directory where you run `mgcl`.
56
+
57
+ For low-level automation, `mgcl skills apply-patch` applies one raw Git patch
58
+ as a single commit.
59
+
24
60
  ## Local Development
25
61
 
26
62
  Run the CLI from source without building: