Add additional information courtesy Matthew and Ake
@@ -26,6 +26,10 @@ Mycroft Skills Manager (msm) is a command line tool used to add, manage and remo
``(.venv) kathyreid@kathyreid-N76VZ:~/mycroft-core$``
+If you are using a Picroft or Mark 1 **Device**, you can activate the `.venv` using the command:
+
+`mycroft-core$ source/opt/venvs/mycroft-core/bin/activate`
+
You can then run `msm`:
`(.venv) kathyreid@kathyreid-N76VZ:~/mycroft-core$ msm update`
@@ -106,13 +110,13 @@ INFO - Nothing new for plasma-activities-skill
INFO - Nothing new for mycroft-pairing
```
-### `msm` errors
+## `msm` errors
The deprecated version of `msm` had several error codes. Instead, this version relies on standard Python errors.
Here are some common errors, what they mean, and how to resolve them.
-#### Git authentication failed
+### Git authentication failed
```bash
ERROR - Error running update_skill on skill-radio-rne: GitException(Git command failed: GitCommandError(['git', 'fetch'], 128, b"remote: Invalid username or password.\nfatal: Authentication failed for 'https://github.com/ChrisFernandez/skill-radio-rne/'", b''))
@@ -120,10 +124,36 @@ ERROR - Error running update_skill on skill-radio-rne: GitException(Git command
This error usually means that the GitHub repository for the **Skill** no longer exists, or has moved. Remove the **Skill** using `msm remove [Skill Name]` and then install a new **Skill**.
-#### Uncommitted changes
+### Uncommitted changes
```bash
ERROR - Error running update_skill on TranslateSkill: SkillModified(Uncommitted changes:
M requirements.sh
)
```
+
+This error usually means that there is a difference between the **Skill** on the **Device** and the **Skill's** GitHub repo. Try re-installing the **Skill**.
+
+### Git command error - not something we can merge
+
+```bash
+ERROR - Error running update_skill on skill-malibu-stacy: GitException(Git command failed: GitCommandError(['git', 'merge', '--ff-only', 'origin/HEAD'], 1, b'merge: origin/HEAD - not something we can merge', b''))
+```
+
+This error usually means that there is no `remote url` defined for the Git repoository (ie. named `origin` - which is the default name of a `remote url`). This often happens during **Skill** development when `git init` is run _without_ defining a `remote url`. To resolve this error, add a `remote url` using the command `git remote add origin https://github.com/yourGitHubUsername/yourrepo.git`.
+
+## Other techniques to resolve Skill installation dependencies
+
+### Forcing the re-installation of dependencies
+
+If you're still running into trouble with dependencies, which can happen during Skill Authoring, there are some other techniques available.
+
+To trigger a `pip` re-installing **Skill** dependencies, do the following:
+
+* Remove the `/home/mycroft/.mycroft/.mycroft-skill` file
+* Remove the `/opt/mycroft/skills/.msm` file
+* Restart the `mycroft-skills` service by using the command `sudo service mycroft-skills restart`
+
+This will force both a **Skills** update and the re-installation of dependencies when the `mycroft-skills` service is re-started.
+
+You can also use the utility `mycroft-pip` which will install dependencies into the Mycroft _virtual environment_ without activation (ie. the 'activate' command). Use `mycroft-pip` as you would regular `pip` for installing Python libraries on which your **Skill** depends.
