list-personas

name	list-personas
description	Lists discovered personify persona assets and summarizes what each one is for.

List Personas

Use this skill when the user wants to know which personify persona assets are currently available.

Source Of Truth

Persona discovery uses a two-directory overlay:

• Bundled starter packs: src/assets/personalities/
• User-owned packs: ${XDG_DATA_HOME:-~/.local/share}/personify/personas/
• Hidden bundled ids: ${XDG_CONFIG_HOME:-~/.config}/personify/hidden.yaml

Read those YAML files directly when listing available personas. Load bundled packs first, then load user-owned packs. If a user-owned pack has the same id as a bundled pack, the user-owned pack overrides the bundled one. If hidden.yaml contains an id, suppress that id from the listing.

Expected hidden-file shape:

hidden:
  - bundled-pack-id

An optional helper script may also be present:

python3 scripts/persona_list.py

Only use that helper if the repo-relative path exists from your current working directory. Do not assume the current working directory is the repository root.

Packaged skills bundle their starter packs under references/personality-packs/, but persistent user-created packs still live in the XDG user directory above. Plugin updates may rebuild bundled skill directories; they must not touch the user-owned persona directory.

What To Report

For each discovered pack, report:

• id
• display_name
• quality_level
• summary

If useful, mention that any listed pack can be used for a session with use-persona or for one request with as-persona.

Important Distinction

Listing a persona asset does not activate it automatically.

A pack can still be used in two ways:

1. Session default: Use use-persona to make it the default voice and reasoning lens for the session.
2. One task: Use as-persona to apply it to the current request or thread.

Limitation

Persona activation is currently a prompt-level convention, not a compiled runtime object. That means:

• it can work without a prebuilt persona-specific wrapper
• it does not automatically create a new installed skill
• it depends on the assistant correctly resolving the requested pack