view release on metacpan or  search on metacpan

lib/App/RoboBot/Plugin/Social/Skills.pm  view on Meta::CPAN

    (whoknows Perl)
    (whoknows Perl Apache PostgreSQL)

=head2 skills

=head3 Description

Displays the list of all skills currently registered by at least one person on
the current network, if called with no arguments. Each skill in the list will
also be shown with the number of people who claim to have some proficiency.

If called with a string argument, that value will be used to display only those
skills which contain the value as a substring. Searching is case-insensitive.

=head3 Usage

[<search string>]

=head3 Examples

    (skills)
    (skills sql)

=head2 skill-add

=head3 Description

Adds a new entry to the skills database, without registering any proficiency
level on your behalf. If the skill already exists, nothing is done.

Note that only skills with at least one registered user on the current network
will be displayed when someone searches or displays the skill list.

=head3 Usage

<skill name>

=head3 Examples

    (skill-add Perl)

=head2 skill-levels

=head3 Description

Displays the list of proficiency levels available for use when registering your
knowledge of a given skill. The proficiency levels are displayed in increasing
order with brief descriptions of each one.

=head3 Examples

    (skill-levels)

=head2 describe-skill

=head3 Description

Permits the addition of a description to a skill. Descriptions are free-form
strings, limited only by the current network's message length limits and
formatting options. Because these descriptions are displayed every single time
someone looks up the skill, it's recommended to keep them brief and to the
point.

=head3 Usage

<skill name> <description>

=head3 Examples

    (describe-skill PostgreSQL "An object-relational database management system.")

=head2 relate-skills

=head3 Description

Relating two skills causes the related skill to be shown whenever the other is
displayed. Related skills are not displayed with their registered users, but
simply referenced as potentially interesting additional skills for the querier
to investigate.

Multiple related skills may be listed and they will all, in turn, be connected
to the original skill.

=head3 Usage

<skill name> <related skill name> [<related skill name> ...]

=head3 Examples

    (relate-skills PostgreSQL SQL)
    (relate-skills Puppet CM Python)

=head2 clear-skills

=head3 Description

Clears the skills list for the given user. It would be wise for most instances
of this software to restrict access to this function via (auth-deny).

=head3 Usage

<nick>

=cut

has '+commands' => (
    default => sub {{
        'iknow' => { method      => 'skill_know',
                     description => 'Assigns a proficiency level to yourself for the named skill. If no skill is named, shows a list of all skills you possess.',
                     usage       => '[<skill name> [<proficiency name or number>]]' },

        'theyknow' => { method      => 'skill_theyknow',
                        description => 'Displays all of the registered skills of the named person. You cannot modify another user\'s skills or proficiencies.',
                        usage       => '<nick>' },

        'idontknow' => { method      => 'skill_dontknow',
                         description => 'Removes you from the list of people with any proficiency in the named skill.',
                         usage       => '<skill name>' },

        'whoknows' => { method      => 'skill_whoknows',
                        description => 'Shows a list of all the people who claim any proficiency in the named skill. Listing multiple skills will perform an intersection and display only those people who have registered knowledge in all of the named ...