@Rouben Rostamian I may have not pushed a current version in awhile. It's supposed to install an examples subdirectory. Will look into that tonight.
1. Typically you execute the shell script from a shell. The example shown in the help page undoubtedly causes some confusion (there the Maple command Bark:-ShellCmd is used to execute the command because Maple help pages typically only show Maple commands).
2. The shell script is not self-contained. It requires Maple. The Bark:-CreateScript command creates two files: the shell script, which is small (5 lines) and an mla which the script uses.
3. The purpose is to allow doing a particular task from the O/S command line, using Maple. For example, one of the tools I created with it will print embedded components of a selected type (Button, ComboBox, etc), with all or selected attributes (id, caption, code, etc) of a given Maple worksheet. It also allows modifying selected attributes. Mainly I use it for tools I use at work. Before creating Bark, I would typically create a bash script that processed the arguments then called Maple. Now I can write everything in Maple, which I prefer.
There appeared to be a bug in Bark:-InstallExamples, which you should normally call from the Bark intro page when installing the package. I've uploaded a revised version. It includes three examples: hello, mhelp (for creating a help database from mw files), and checkmo (useful with MapleSim for checking/listing/printing the content of MapleSim modelica libraries).