← Back to Skills Marketplace
lookupmark

Polito Notes

by LookUpMark · GitHub ↗ · v1.2.1 · MIT-0
cross-platform ⚠ suspicious
134
Downloads
0
Stars
0
Active Installs
5
Versions
Install in OpenClaw
/install polito-notes
Description
Convert PDF lecture slides into comprehensive bilingual (IT+EN) markdown notes for Polito university courses. Use when the user sends a PDF and specifies a c...
Usage Guidance
This skill appears to do what it says (convert PDFs into bilingual markdown files), but it expects access to specific local folders and tools that the metadata doesn't declare. Before installing/using it: 1) Confirm you want the agent to read and write under ~/Documenti/github/polito (it will list folders, infer lecture numbers, create/overwrite notes and .bak files). 2) Be aware of the 'Zero information loss' rule — sensitive or personal data inside PDFs will be copied verbatim into the notes. If that is a concern, do not process sensitive documents or ask the author to redact them first. 3) The skill references local-rag and an ~/.openclaw workspace path; verify whether those paths exist and whether you want automatic indexing/search of generated notes. 4) Because this is instruction-only (no bundled code), make sure pdftotext and python3 are installed locally; test first with a non-sensitive PDF to confirm behavior. 5) If you want stronger safety: request the skill author declare required config paths and offer an option to redact personal data or require explicit user confirmation before writing/overwriting files.
Capability Analysis
Type: OpenClaw Skill Name: polito-notes Version: 1.2.1 The 'polito-notes' skill is a legitimate utility designed to automate the conversion of PDF lecture slides into bilingual (Italian and English) markdown notes for university courses. It defines a clear directory structure, uses standard PDF processing tools (pdftotext, pdfminer.six), and follows a specific academic template. No indicators of data exfiltration, malicious execution, or unauthorized access were found in SKILL.md or _meta.json.
Capability Assessment
Purpose & Capability
The skill's stated purpose (convert lecture PDFs into Italian and English markdown notes and place them in a course folder) aligns with the instructions to extract text, generate markdown, and write files under ~/Documenti/github/polito. However, the SKILL.md also references specific local components (e.g., ~/.local/share/local-rag/venv/ and ~/.openclaw/workspace/skills/lookupmark-local-rag/...) that go beyond a simple PDF-to-markdown converter and are not declared in the skill metadata (no required config paths or env vars). This is an unexplained dependence on local tooling and paths.
Instruction Scope
Instructions instruct the agent to read the user's filesystem (check/resolve ~/Documenti/github/polito folders), run pdftotext or a python fallback, create/overwrite files, and create backups. They also require 'Zero information loss' and explicitly state that PDF content will be preserved verbatim, which increases the risk of capturing sensitive or personal data. The instructions also reference running a local query script under ~/.openclaw/workspace/... for immediate search; these filesystem/behavioral expectations are broader than what the skill metadata declares and grant the agent broad discretion to read and write user files.
Install Mechanism
This is an instruction-only skill with no install spec and no bundled code — lowest install risk. The SKILL.md lists runtime dependencies (pdftotext, python3, and an optional local-rag venv), but there is no automated installer or remote download. That reduces supply-chain risk, though it does assume the user has particular tools and local paths available.
Credentials
The skill declares no required environment variables or config paths in metadata, yet the runtime instructions rely on specific local paths (~/.local/share/local-rag/venv, ~/.openclaw/workspace/skills/...) and the user's personal notes repository (~/Documenti/github/polito). This mismatch means the skill expects access to private filesystem locations without declaring them. Also, the 'Zero information loss' rule means potentially sensitive content from PDFs will be preserved and written to disk; that is a high privacy burden relative to the simple conversion task.
Persistence & Privilege
The skill is not set to always:true and does not request perpetual presence. It instructs the agent to write files into the user's notes repo and to create backups (notes.md.bak), which is consistent with its purpose. It does reference automatic pickup by a separate local-rag skill during indexing, but that is a usage note rather than an escalation of privileges within this skill.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install polito-notes
  3. After installation, invoke the skill by name or use /polito-notes
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.1
Explicit VENV path, backup before overwrite rule, sensitive data warning
v1.2.0
Declared dependencies (pdftotext, python3, venv).
v1.1.0
Added Mermaid fallback for complex figures. RAG cross-reference. Example output structure.
v1.0.1
Dependency + config refresh
v1.0.0
Initial release: bilingual PDF-to-markdown notes pipeline for Polito courses
Metadata
Slug polito-notes
Version 1.2.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 5
Frequently Asked Questions

What is Polito Notes?

Convert PDF lecture slides into comprehensive bilingual (IT+EN) markdown notes for Polito university courses. Use when the user sends a PDF and specifies a c... It is an AI Agent Skill for Claude Code / OpenClaw, with 134 downloads so far.

How do I install Polito Notes?

Run "/install polito-notes" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Polito Notes free?

Yes, Polito Notes is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Polito Notes support?

Polito Notes is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Polito Notes?

It is built and maintained by LookUpMark (@lookupmark); the current version is v1.2.1.

💬 Comments