agentic-persona

Quickstart · API and commands · Package

agentic-persona is an open-source persona profile and text-checking toolkit for developers building AI content workflows. It checks literal voice phrases, banned phrases, and disclosure text. Its Node.js library, CLI, and Model Context Protocol (MCP) server also build image, video, and caption prompt strings.

Install

npm install agentic-persona

Requires Node.js 18 or later. Includes TypeScript declarations and two runtime dependencies.

Check your first caption

Save this example as check-persona.mjs after installation. Run node check-persona.mjs. No API keys, environment variables, or .env loading are required.

import { definePersona, consistencyCheck, promptPack } from 'agentic-persona';

const persona = definePersona({
  name: 'Ari', handle: '@ari', niche: 'sustainable fashion',
  voiceRules: ['warm', 'practical'], bannedPhrases: ['guaranteed'],
  disclosureLine: 'Created with AI assistance.',
  visualStyle: 'sunlit editorial portrait', voiceStyle: 'calm and conversational'
});
console.log(consistencyCheck(persona,
  'A warm, practical tip. Created with AI assistance.'));
console.log(promptPack(persona, 'repairing denim'));

The check prints score: 100, empty flags, and missingDisclosure: false. The prompt pack contains imagePrompt, videoPrompt, and captionPrompt. It generates text, not media assets.

How it works

Profile -> validate and freeze -> persona
                                    |
                      +-------------+--------------+
                      |                            |
              caption substring checks     topic prompt templates
                      |                            |
              score and flags               image/video/caption strings

Why it exists

A profile can keep identity fields and disclosure instructions in one place across content workflows. textlint supports general prose rules. Promptfoo tests prompts and AI systems. This package provides a smaller local profile checker and fixed prompt templates without model calls.

Compare

Checked 2026-10-14 against textlint's source and Promptfoo's source. These are alternatives for content checks or prompt evaluation, with different scopes.

Coverage

The source exports six persona functions and two routing adapters. Tests cover local behavior and mocked HTTP routing. No external integration is credential-verified by this rewrite. Prompt templates do not call an image, video, or lang

... View full README on GitHub