Audit Report: memento-flashcards — 🟠 D (48/100)

Audited by TAR Engine · 2026-07-17 · Report format v0.2

Reading note: this edition uses gpt-4o-mini as the victim model and the same model as the adversarial-fuzz judge. Findings reflect missing defenses in the SKILL.md itself — not a verdict on any specific victim model. The remediation belongs in SKILL.md, not in the model.

Source: https://github.com/NousResearch/hermes-agent/blob/main/optional-skills/productivity/memento-flashcards/SKILL.md

Verdict: High risk — 3 high-severity issues need author attention before deploying to a shared environment.

What this skill does

Auditor's read (LLM-generated): The memento-flashcards skill allows users to create, review, and manage flashcards using a spaced-repetition system. It enables users to generate flashcards from factual statements, grade free-text answers, and create quizzes from YouTube transcripts, while storing all card data in a local JSON file. The skill also supports importing and exporting flashcard decks as CSV files and utilizes a command-line interface for various operations.

Author description: >-

Observed: memento-flashcards is 7 top-level sections (Overview, When to Use, Quick Reference, Card Storage, Procedure, …); ~306 lines of instructions, delegates to packaged scripts, concise body.

Frontmatter facts:

• Body size: 306 lines / 12587 chars

Score breakdown by category

Each category gets its own sub-score. A category with no rule hits gets 100; a category with a single critical finding drops to 80.

Historical baseline (same-skill comparison)

• Prior audits on record: 1 (first 2026-06-13T20:34:02.533482Z, most recent prior 2026-06-13T20:34:02.533482Z)
• Score statistics: mean 30.0 ± 0.0 (range 30–30) (normal band: 27.0 – 33.0)
• This audit vs last: +18 (📈 improved)
• Out-of-band notice: this score is outside the skill's historical normal band — worth a closer read.
• Top recurring findings across history:
• SEM-006 — hit in 1 of 1 prior audits (100.0%)
• SEM-008 — hit in 1 of 1 prior audits (100.0%)
• SEM-002 — hit in 1 of 1 prior audits (100.0%)
• SEM-003 — hit in 1 of 1 prior audits (100.0%)
• SEM-004 — hit in 1 of 1 prior audits (100.0%)

Baseline assumes the skill's name + description haven't changed. A rename or rewrite starts a fresh baseline.

Findings

9 rules matched. Each finding below cites the matched line and a remediation hint.

1. 🟠 SEM-008 — external_payload_blind_trust (HIGH)

• Category: Malicious payload signatures
• Why this matched: The skill accepts and processes transcripts fetched from YouTube without validating their content, which could lead to the generation of inappropriate or harmful quiz questions based on unreliable data.
• Rule intent: Trusts external content (downloaded file, remote prompt template, third-party output) without validation
• Matches in document: 1

Evidence (1 of 1 match):

Line 207:

This returns {"title": "...", "transcript": "..."} or an error.

Suggested fix: Add validation checks for the fetched transcript to ensure it meets certain criteria (e.g., length, content type) before using it to generate quiz questions.

2. 🟠 SEM-002 — ambiguous_instruction (HIGH)

• Category: Prompt injection / scope override
• Why this matched: The phrasing 'Want me to save this as a Memento flashcard?' could lead a user to respond affirmatively even if they do not intend to save the information, potentially resulting in unintended flashcard creation.
• Rule intent: Ambiguous instruction that could be exploited as a prompt injection primitive
• Matches in document: 1

Evidence (1 of 1 match):

Line 53:

Ask "Want me to save this as a Memento flashcard?" — only create if confirmed

Suggested fix: Rephrase the question to be more explicit, such as 'Are you sure you want to save this statement as a flashcard?' to ensure the user clearly understands the action they are confirming.

3. 🟠 SEM-007 — irreversible_action_no_confirmation (HIGH)

• Category: Shell safety
• Why this matched: Automatically creating a flashcard without user confirmation for explicit intent could lead to unintended data being saved, especially if the user mistakenly provides information they did not want to save.
• Rule intent: Skill instructs the LLM to take an irreversible action without explicit user confirmation
• Matches in document: 1

Evidence (1 of 1 match):

Line 83:

**create the card directly**, no confirmation needed.

Suggested fix: Implement a confirmation step for all actions that result in irreversible changes, such as creating a flashcard, to ensure the user explicitly agrees to the action.

4. 🟡 SEM-006 — credential_handling_unsafe (WARNING)

• Category: Credential exposure
• Why this matched: While not directly handling credentials, instructing users to install a package without mentioning secure handling practices could lead to users inadvertently exposing sensitive information if they are not careful.
• Rule intent: Credentials/tokens handled in ways that risk exposure (logging, echoing, including in prompts)
• Matches in document: 1

Evidence (1 of 1 match):

Line 211:

pip install youtube-transcript-api

Suggested fix: Include a note on secure handling of credentials and sensitive information when guiding users to install dependencies, emphasizing the importance of using secure environments.

5. 🟡 SEM-004 — prompt_injection_subtle (WARNING)

• Category: Prompt injection / scope override
• Why this matched: The instruction to always provide feedback before proceeding could be exploited by an adversarial user to manipulate the flow of conversation and inject unwanted prompts or commands.
• Rule intent: Subtle nudge to hide, mislead, or impersonate that regex couldn't catch
• Matches in document: 1

Evidence (1 of 1 match):

Line 258:

You MUST reply to the user with feedback before doing anything else.

Suggested fix: Implement checks to sanitize user inputs and ensure that feedback does not inadvertently allow for prompt injections or unintended command executions.

6. 🟡 SEM-003 — capability_overreach (WARNING)

• Category: Prompt injection / scope override
• Why this matched: Requiring terminal access may grant the skill broader capabilities than necessary for its stated purpose, potentially leading to misuse or unintended actions.
• Rule intent: Capability claim over-broad relative to the skill's stated purpose
• Matches in document: 1

Evidence (1 of 1 match):

Line 15:

requires_toolsets: [terminal]

Suggested fix: Reassess the need for terminal access and limit permissions to only what is necessary for the skill's functionality, ensuring it does not exceed its intended scope.

7. 🟡 SUP-003 — unpinned_dependency (WARNING)

• Category: Supply chain (deps + CVE)
• Why this matched: youtube-transcript-api (PyPI) installed without a version pin — silent drift every time the skill runs.
• Rule intent: Unpinned dependencies break audit reproducibility and let upstream changes silently alter behavior. Critical bug fixes, license changes, or compromised releases all slip in invisibly.
• Matches in document: 1

Evidence (1 of 1 match):

Line 211:

pip install youtube-transcript-api

Suggested fix: Pin to a known-good version: pip install youtube-transcript-api==X.Y.Z or npm install youtube-transcript-api@X.Y.Z.

8. 🔵 QL-001 — shell_block_no_error_handling (INFO)

• Category: quality
• Why this matched: Shell block missing set -e / || exit — silent failures will go unreported
• Rule intent: Shell code blocks without set -e or explicit error handling
• Matches in document: 13

Evidence (3 of 13 matches):

Line 106:

    105: 
>>  106: ```bash
>>  107: python3 ~/.hermes/skills/productivity/memento-flashcards/scripts/memento_cards.py add \
>>  108:   --question "What year did World War 2 end?" \
>>  109:   --answer "1945" \
>>  110:   --collection "History"
>>  111: ```
    112: 

Line 130:

    129: 
>>  130: ```bash
>>  131: python3 ~/.hermes/skills/productivity/memento-flashcards/scripts/memento_cards.py due
>>  132: ```
    133: 

Line 136:

    135: 
>>  136: ```bash
>>  137: python3 ~/.hermes/skills/productivity/memento-flashcards/scripts/memento_cards.py due --collection "History"
>>  138: ```
    139: 

Suggested fix: Add set -euo pipefail at the top of bash blocks, or chain critical commands with || exit 1. Skills that fail silently mid-script are nearly impossible to debug downstream.

9. 🔵 QL-002 — unpinned_install_command (INFO)

• Category: quality
• Why this matched: Install command lacks a pinned version — re-running the skill on a different day may install a different binary
• Rule intent: Documented install command without a pinned version
• Matches in document: 1

Evidence (1 of 1 match):

Line 210:

    209: If the script reports `missing_dependency`, tell the user to install it:
>>  210: ```bash
>>  211: pip install youtube-transcript-api
    212: ```

Suggested fix: Pin versions in the README/SKILL.md command: npm install foo@1.2.3 or pip install foo==1.2.3. Reproducibility matters once anyone else runs the skill.

Scope of this edition

The audit covers static rule matching, semantic-layer LLM analysis, and adversarial prompt fuzzing. Three classes of risk live beyond this edition's scope. We name them explicitly:

• Runtime behavior. Verifying what a skill actually does at runtime requires sandboxed execution. That layer ships in a future edition; today's report reflects what the skill states it will do, plus the LLM's read of how it would behave.
• Cross-skill composition. When this skill is chained with others through a planner, the emergent state flow between skills is its own analysis surface. Out of scope for single-skill reports.
• External payloads. A skill that fetches and runs a remote script is flagged at the fetch step. The remote payload itself is audited as a follow-up once the sandbox layer is online.

Methodology

How the score was computed:

1. Document text is scanned against a static rule set of 32 signature patterns. Each rule carries a permanent rule_id (e.g. PI-001), a category, a severity, and a remediation template.
2. Each rule hit deducts from a 100-point base: critical -20, high -10, warning -5, info -1.
3. The letter grade is gated by max severity AND total score: any critical → F; any high → at most D; any warning → at most C; otherwise A/B by score band.
4. Per-category sub-scores apply the same deduction formula to that category's findings only — so you can see WHICH risk surface drove the loss.

Rule matches are augmented by an LLM-based semantic pass when an LLM endpoint is configured. The semantic pass uses rule IDs SEM-001 … SEM-008.

When an LLM endpoint is configured the skill is also probed with a 15-attack adversarial corpus (5 classes × 3 prompts), each judged by a separate LLM call. Failed classes surface as rule IDs AR-001 … AR-005.

Engine + rule set provenance:

• Engine version: 0.2.0
• Rule set version: 1.1.0
• Commit: unknown
• Domain config: general
• Audited at: 2026-07-17T20:33:58.280185Z
• Rules applied: 36 static rules (full registry below)

Known limitations of this report

• False positives are possible. A SKILL.md documenting a dangerous pattern (e.g. an audit skill explaining curl | sh) will match the rule even though the skill's intent is to detect, not execute. Read the matched lines before reacting.
• False negatives are guaranteed in narrow ways. Patterns obfuscated by string concatenation, environment variable indirection, or non-English equivalents will slip past regex.
• Baseline sample size. Same-skill trend analysis (§ Historical baseline) gets meaningful with n≥3 prior audits. With fewer priors the stddev band is widened to avoid false out-of-band signals.

About TAR Engine

TAR Engine is an OSS "wish machine" with built-in audit. Speak a goal; the engine plans, runs and audits skills inside its own container. BYOK. — github.com/qingxuantang/tar-engine